5709a7858d5c197721be66d5218a79124abadb70 lrnassar Tue Mar 17 08:46:31 2026 -0700 Adding alt text to images across static documentation pages, CGI headers, markdown docs, and Pandoc templates. Content images receive AI-generated descriptive alt text; decorative images (icons, spacers, toggles) receive alt="" per WCAG best practice. Also adds Image Descriptions section to the accessibility page, and fixes Pandoc Lua writers to output alt attributes. 67 files, covering help docs, news archive, ENCODE pages, portal pages, and session examples. refs #37254 diff --git src/hg/htdocs/goldenPath/help/metadata.html src/hg/htdocs/goldenPath/help/metadata.html index 1208894644a..aefe7a9e0be 100755 --- src/hg/htdocs/goldenPath/help/metadata.html +++ src/hg/htdocs/goldenPath/help/metadata.html @@ -1,257 +1,257 @@ <!DOCTYPE html> <!--#set var="TITLE" value="Adding Track Metadata" --> <!--#set var="ROOT" value="../.." --> <!-- Relative paths to support mirror sites with non-standard GB docs install --> <!--#include virtual="$ROOT/inc/gbPageStart.html" --> <h1>Adding metadata to tracks</h1> <h2>Contents</h2> <h6><a href="#intro">Adding metadata to tracks</a></h6> <h6><a href="#metadata">Previous metadata versions</a></h6> <h6><a href="#tagstorm">Tagstorm metadata</a></h6> <h6><a href="#tabsep">Tab-separated metadata</a></h6> <a name="intro"></a> <h2>Adding metadata to tracks</h2> <p> Adding metadata to your tracks about cell lines, experimental protocols, or assays can be accomplished in a number of ways, via the newly supported <em>metaDb</em> or <em>metaTab</em> trackDb fields, or via the older style <em>metadata</em> trackDb field. The <em>metaDb</em> and <em>metaTab</em> fields link external tagStorm or tab-separated metadata files to the data in the hub. The new formats are preferred over the older <em>metadata</em> field, although the <em>metadata</em> lines will continue to be supported for track hubs, but no new features will be added as they will for tagStorm and tab-separated files.</p> <p> The following is an example of a <a href="hgTrackHubHelp.html#genomes.txt">genomes.txt</a> file calling the tagStorm metadata file: </p> <pre> genome hg38 metaDb relativePath/to/tagStorm.txt</pre> <p> and specifying a tab-separated metadata file:</p> <pre> genome hg38 metaTab relativePath/to/tabSep.txt</pre> <p> When using tab-separated or tagStorm metadata, a <a href="/goldenPath/help/trackDb/trackDbHub.html#meta"><em>meta</em></a> column or line will be needed to specify which metadata information is applied to a track. The <em>meta</em> value should be a unique alphanumeric string. </p> <a name="metadata"></a> <h2>Previous metadata versions</h2> <p> Currently, in order to add metadata to your tracks, you must specify all of the metadata key-value pairs in each stanza of a track that includes metadata, like the last line of the following example: </p> <pre> track experiment1 shortLabel Donor A longLabel Donor A's Metadata Experiment type bigWig bigDataUrl http://genome.ucsc.edu/goldenPath/help/examples/bigWigExample.bw parent treatmentX on subGroups view=X metadata differentiation="10 hour" treatment=X donor=A lab="List Meta Lab" data_set_id=ucscTest1 access=group assay=long-RNA-seq enriched_in=exon life_stage=postpartum species="Homo sapiens" ucsc_db=hg38 </pre> <p> Each track must have a separate <em>metadata</em> field and its own list of key-values, which can become cumbersome when each track in a group all share a common subset of metadata. For instance, if there are 10 tracks in a composite or multiWig, where each subtrack only differs in the "differentiation" tag, it would be more convenient to have a shared set of metadata and then specify the differences for each track. This is the motivation behind the tagStorm format, described below. </p> <p> You can find an example of a hub using the metadata example <a href="/goldenPath/help/examples/hubExamples/hubMetadata/metadataHub.txt">here</a> and you can load the following session to view the hub, <a href="https://genome.ucsc.edu/s/PublicSessions/metadata_field"> https://genome.ucsc.edu/s/PublicSessions/metadata_field</a>. <a name="tagstorm"></a> <h2>Tagstorm metadata</h2> <p> The tagStorm format is a plain text file similar to a <a href="trackDb/trackDbHub.html"<em>trackDb</em></a> file that describes all of the tracks in a <a href="hgTrackHubHelp.html">track hub</a>, in that both are files where the first word in a line is the tag and the rest of the line is the value, and different stanza's are line delimited. TagStorm's are also similar to a spreadsheet, where a tag corresponds to a column and a stanza to an entire row. The tagStorm format is easy for computers to parse, reduce the redundancy of a tab-separated file, and they are human readable. Here is a canonical tagStorm example: </p> <pre> lab tagStorm Lab data_set_id ucscTest1 access group assay long-RNA-seq enriched_in exon life_stage postpartum species Homo sapiens ucsc_db hg38 treatment X donor A differentiation 10 hour meta ucsc1_1 differentiation 1 day meta ucsc1_4 differentiation 5 days meta ucsc1_7 treatment Y donor B differentiation 10 hour meta ucsc1_2 differentiation 1 day meta ucsc1_5 differentiation 5 days meta ucsc1_8 donor C differentiation 10 hour meta ucsc1_3 differentiation 1 day meta ucsc1_6 differentiation 5 days meta ucsc1_9 </pre> <p> Each stanza, such as "donor B", inherits from any stanzas above it at the right indentation level, and is a parent to stanzas beneath. In the <a href="/goldenPath/help/examples/hubExamples/hubMetadata/tagStorm.txt">example</a> above, Treatment Y applies to both "donor B" and "donor C". Treatment X only applies to "donor A" as they are at the same indentation level. There are three differentiation times that apply to each of the donors and they can be referenced in the trackDb stanza using the <a href="/goldenPath/help/trackDb/trackDbHub.html#meta"><em>meta</em></a> line in the <a href="/goldenPath/help/examples/hubExamples/hubMetadata/tagStorm.txt">tagStorm file</a>, i.e., <code>meta ucsc1_1</code>. </p> <p> The <code>meta ucsc1_1</code> line would reference the following metadata:</p> <pre> lab tagStorm Lab data_set_id ucscTest1 access group assay long-RNA-seq enriched_in exon life_stage postpartum species Homo sapiens ucsc_db hg38 treatment X donor A differentiation 10 hour </pre> <p> A trackDb stanza using the <a href="/goldenPath/help/examples/hubExamples/hubMetadata/tagStorm.txt">tagStorm metadata</a> can be seen in the following example: </p> <pre> track experiment1 shortLabel Donor A longLabel Donor A's TagStorm Experiment type bigWig bigDataUrl http://genome.ucsc.edu/goldenPath/help/examples/bigWigExample.bw parent treatmentX on subGroups view=X meta ucsc1_1 </pre> <p> You can find the complete example of the hub using the tagStorm metadata <a href="/goldenPath/help/examples/hubExamples/hubMetadata/tagStormHub.txt">here</a> and you can load the following session to view the hub, <a href="https://genome.ucsc.edu/s/PublicSessions/tagStorm_metadata"> https://genome.ucssc.edu/s/PublicSessions/tagStorm_metadata</a>. The hub uses a composite track, so if you are unfamiliar with composite tracks, the <a href="/goldenpath/help/hubQuickStartGroups.html#composite">Quick Start Guide</a> on composites can explain how the tracks are organized. The details page for the trackDb stanza example (Donor A) can be seen below.</p> <p> -<img class="gbsInlineImg" src="../../images/tagStorm.png"> +<img alt="" class="gbsInlineImg" src="../../images/tagStorm.png"> </p> <a name="tabsep"></a> <h2>Tab-separated metadata</h2> <p> Column or tab-separated metadata can be useful to store computer readable information as an array. While this format is very easy for a computer to parse, it can be bit confusing or difficult for humans to read and interpret. As you can see in the <a href="/goldenPath/help/examples/hubExamples/hubMetadata/tabSep.txt">example</a> below, many columns become redundant as they repeat the same information on each line. </p> <pre> #lab data_set_id access assay enriched_in life_stage species ucsc_db treatment donor differentiation meta tabSepLab ucscTest1 group long-RNA-seq exon postpartum Homo sapiens hg38 X A 10 hour ucsc1_1 tabSepLab ucscTest1 group long-RNA-seq exon postpartum Homo sapiens hg38 X A 1 day ucsc1_4 tabSepLab ucscTest1 group long-RNA-seq exon postpartum Homo sapiens hg38 X A 5 days ucsc1_7 tabSepLab ucscTest1 group long-RNA-seq exon postpartum Homo sapiens hg38 Y B 10 hour ucsc1_2 tabSepLab ucscTest1 group long-RNA-seq exon postpartum Homo sapiens hg38 Y B 1 day ucsc1_5 tabSepLab ucscTest1 group long-RNA-seq exon postpartum Homo sapiens hg38 Y B 5 days ucsc1_8 tabSepLab ucscTest1 group long-RNA-seq exon postpartum Homo sapiens hg38 Y C 10 hour ucsc1_3 tabSepLab ucscTest1 group long-RNA-seq exon postpartum Homo sapiens hg38 Y C 1 day ucsc1_6 tabSepLab ucscTest1 group long-RNA-seq exon postpartum Homo sapiens hg38 Y C 5 days ucsc1_9 </pre> <p> To reference a line in the TSV or CSV file in the trackDb stanza, a <a href="/goldenPath/help/trackDb/trackDbHub.html#meta"><em>meta</em></a> column must contain a unique alpha-numeric string. For example, <code>ucsc1_1</code> would reference the following metadata in your track: </p> <pre> #lab data_set_id access assay enriched_in life_stage species ucsc_db treatment donor differentiation meta tabSepLab ucscTest1 group long-RNA-seq exon postpartum Homo sapiens hg38 X A 10 hour ucsc1_1 </pre> <p> A trackDb stanza using the <a href="/goldenPath/help/examples/hubExamples/hubMetadata/tabSep.txt">tab-separated metadata</a> can be seen in the following example: </p> <pre> track experiment1 shortLabel Donor A longLabel Donor A's Tab Separated Experiment type bigWig bigDataUrl http://genome.ucsc.edu/goldenPath/help/examples/bigWigExample.bw parent treatmentX on subGroups view=X meta ucsc1_1 </pre> <p> You can find the complete example of the hub using the tab-separated metadata <a href="/goldenPath/help/examples/hubExamples/hubMetadata/tabSepHub.txt">here</a> and you can load the following session to view the hub, <a href="https://genome.ucsc.edu/s/PublicSessions/TabSeparated_metadata"> https://genome.ucsc.edu/s/PublicSessions/TabSeparated_metadata</a>. The hub uses a composite track, so if you are unfamiliar with composite tracks, the <a href="/goldenpath/help/hubQuickStartGroups.html#composite">Quick Start Guide</a> on composites can explain how the tracks are organized. The details page for the trackDb stanza example (Donor A) can be seen below.</p> <p> -<img class="gbsInlineImg" src="../../images/tabSep.png"> +<img alt="" class="gbsInlineImg" src="../../images/tabSep.png"> </p> <!--#include virtual="$ROOT/inc/gbPageEnd.html" -->