4a87b1269ea7ed40e2904c15bafda61f62d4f567 mspeir Wed Jan 7 11:33:28 2026 -0800 Adding information about include statements to hub docs, refs #20909 diff --git src/hg/htdocs/goldenPath/help/trackDb/trackDbHub.v3.html src/hg/htdocs/goldenPath/help/trackDb/trackDbHub.v3.html index cc56ea73716..d6b5a81af4d 100755 --- src/hg/htdocs/goldenPath/help/trackDb/trackDbHub.v3.html +++ src/hg/htdocs/goldenPath/help/trackDb/trackDbHub.v3.html @@ -152,30 +152,37 @@ <h3 id="useOneFile">Use <b><code>useOneFile on</code></b> for hubs with only one genome</h3> <p> This page focuses on the settings found in the <a target="_blank" href="../hgTrackHubHelp.html#trackDb.txt"><code>trackDb.txt</code></a> file; however, all hubs must include a top-level <a target="_blank" href="../hgTrackHubHelp.html#hub.txt"><code>hub.txt</code></a>. If your hub is only displaying one genome, there is a way to put the <a target="_blank" href="../hgTrackHubHelp.html#genomes.txt"><code>genomes.txt</code></a> and <a target="_blank" href="../hgTrackHubHelp.html#trackDb.txt"><code>trackDb.txt</code></a> all into one file. Read about the special <a target="_blank" href="../hgTracksHelp.html#UseOneFile"><code>useOneFile on</code></a> setting to allow all a hub to exist in one file. Load a working example <a target="_blank" href="../examples/hubExamples/hubUseOneFile/singleFileHubExample.txt">here</a>.</p> +<h3 id="includes">Using trackDb include statements</h3> +<p> +Hubs also support the use of <a href="../hgTrackHubHelp.html#Includes">include +statements</a>, allowing one to insert a file containing a set of trackDb +stanzas into a primary trackDb. Use this when you have the same track across +several assemblies, or several large, complex tracks. + <h3 id="assembly_hubs">Assembly Hubs</h3> <p> This page focuses on the settings found in the <a target="_blank" href="../hgTrackHubHelp.html#trackDb.txt"><code>trackDb.txt</code></a> file used in both Track Hubs and Assembly Hubs; however, this page does not describe the settings unique to Assembly Hubs. Track Hubs can display novel genomes, through a type of hub called an <a href="../hgTrackHubHelp.html#Assembly" target="_blank">Assembly Hub</a>. The <a href="../hgTrackHubHelp.html#example_genomes.txt" target="_blank"><code>genomes.txt</code></a> file for an Assembly Hub involves many additional settings not described on this page, such as <a href="../hgTrackHubHelp.html#twoBitPath" target="_blank"><code>twoBitPath</code></a> and <a href="../hgTrackHubHelp.html#defaultPos" target="_blank"><code>defaultPos</code></a> to identify the location of the sequence for the novel assembly and what default position to display. The <code>genomes.txt</code> file in Assembly Hubs also requires display information such as <a href="../hgTrackHubHelp.html#organism" target="_blank"><code>organism</code></a>,