https://til.andrew-quinn.me/tags/static-site-generators/ Recent content in Static-Site-Generators on Andrew Quinn's TILs https://til.andrew-quinn.me/papermod-cover.png https://til.andrew-quinn.me/papermod-cover.png Hugo -- gohugo.io en-us Thu, 30 Nov 2023 00:00:00 +0000 https://til.andrew-quinn.me/posts/things-word-has-that-ssgs-by-and-large-don-t/ Thu, 30 Nov 2023 00:00:00 +0000 https://til.andrew-quinn.me/posts/things-word-has-that-ssgs-by-and-large-don-t/ <p>Recommendations appreciated.</p> <p>Disclaimer: Most of these make little sense in an Internet medium anyway.</p> <ul> <li>An <em>index</em>. An index simply lists the terms and topics discussed in a document, along with the pages they are listed on.</li> <li>A <em>glossary</em>. Could be as simple as a CSV file of terms and definitions, or as complex as a whole extra <code>glossary/</code> folder.</li> <li>Related: A &ldquo;Acronyms and Abbreviations&rdquo; section. Even moreso than the last, this could be a simple CSV.</li> <li>A built-in <em>site-wide search</em> function. Word gets around this by having everything open at once.</li> <li>A <em>list of tables</em>. Huge if you want your dead-trees books to match your shiny new website.</li> <li>A <em>list of figures</em>. Ditto.</li> <li>A <em>list of referenced external documents.</em> CSV! Say it with me!</li> </ul> <p>The reason I compiled this list was because I decided to investigate whether I could use Hugo at work to generate our client-facing documentation. Currently we are using an unholy combination of Word and Confluence, and I figured that the magic of Git might help us keep our docs updated in a more sane way.</p>