I changed the way I create links to use references to a data YML file instead of relying on the capture tag and including reference to the file with the captions. Using the capture tag was highly susceptible to broken links and way too manual. See the Links topic for more detail about the new method.

This commit is contained in:
Tom Johnson
2015-09-13 16:33:16 -07:00
parent a24859dc66
commit 445b1d1f44
59 changed files with 14296 additions and 14054 deletions

View File

@ -5,24 +5,24 @@ keywords: layouts, information design, presentation
last_updated: August 12, 2015
summary: "This theme has a few special layouts. Special layouts include the JS files they need directly in the page. The JavaScript for each special layout does not load by default for every page in the site."
---
{% include linkrefs.html %}
{{note}} By "layout," I'm not referring to the layouts in \_layouts in the project files. I'm referring to special ways of presenting information on the same "page" layout. {{end}}
{{site.data.alerts.note}} By "layout," I'm not referring to the layouts in \_layouts in the project files. I'm referring to special ways of presenting information on the same "page" layout. {{site.data.alerts.end}}
## FAQ layout
See {{doc_faq}} for an example of the FAQ format, which follows an accordion, collapse/expand format. This code is from Bootstrap.
See {{site.data.urls.doc_faq.link}} for an example of the FAQ format, which follows an accordion, collapse/expand format. This code is from Bootstrap.
## Knowledgebase layout
See {{doc_kb_layout}} for a possible layout for knowledge base articles. This layout looks for pages containing specific tags.
See {{site.data.urls.doc_kb_layout.link}} for a possible layout for knowledge base articles. This layout looks for pages containing specific tags.
## Scroll layout
If you have a long JSON message you're documenting, see the {{doc_scroll}}. This layout adds a side pane showing links to pointers in the left pane.
If you have a long JSON message you're documenting, see the {{site.data.urls.doc_scroll.link}}. This layout adds a side pane showing links to pointers in the left pane.
## Shuffle layout
If you want a dynamic card layout that allows you to filter the cards, see {{doc_shuffle}}. This uses the Shuffle JS library.
If you want a dynamic card layout that allows you to filter the cards, see {{site.data.urls.doc_shuffle.link}}. This uses the Shuffle JS library.