https://davidfeng.us/notes/ Recent content in Notes on David Feng Hugo en david.feng.ge@gmail.com (David Feng) david.feng.ge@gmail.com (David Feng) Fri, 10 Jul 2026 21:56:30 -0400 https://davidfeng.us/notes/2026/07/hugo/ Fri, 10 Jul 2026 21:56:30 -0400david.feng.ge@gmail.com (David Feng) https://davidfeng.us/notes/2026/07/hugo/ <ul> <li>Quick Reference <ul> <li>Create a new single page <ul> <li><code>hugo new posts/a/index.md</code></li> <li><code>index.zh-cn.md</code> for Chinese version</li> </ul> </li> <li>Local preview at <code>localhost: 1313</code> <ul> <li><code>hugo server</code> ( <code>-D</code> to include drafts)</li> </ul> </li> <li>Update all submodules <ul> <li><code>git submodule init</code></li> <li><code>git pull --recurse-submodules</code> or <code>git submodule update --remote --merge</code></li> </ul> </li> <li>version <ul> <li><code>hugo version</code> show current version</li> <li><code>brew upgrade hugo</code> upgrade to latest version</li> </ul> </li> <li>If a page bundle is Chinese only <ul> <li>no need to have index.md placeholder</li> <li>use <code>test.jpg</code> in index.zh-cn.md to refer to the <code>test.zh-cn.jpg</code> file <ul> <li><code></code> and <code>figure</code> shortcode both work</li> </ul> </li> </ul> </li> </ul> </li> <li>doc style themes <ul> <li>Learn <a href="https://learn.netlify.app/en/" target="_blank" rel="noopener noreferrer">https://learn.netlify.app/en/</a> <ul> <li>good for linear tutorial</li> </ul> </li> <li>Doks <a href="https://doks.netlify.app/" target="_blank" rel="noopener noreferrer">https://doks.netlify.app/</a> <ul> <li>contains both docs and blog session and look good</li> <li>search only shows page. no highlight within context.</li> <li>Next blog theme?! Sell myself as a product?</li> </ul> </li> <li>Book <a href="https://hugo-book-demo.netlify.app/" target="_blank" rel="noopener noreferrer">https://hugo-book-demo.netlify.app/</a> <ul> <li>used to use this one. does not look that good</li> </ul> </li> <li>Geekdocs <a href="https://geekdocs.de" target="_blank" rel="noopener noreferrer">https://geekdocs.de</a> <ul> <li>similar to book but looks slightly nicer</li> </ul> </li> <li>Docsy <a href="https://example.docsy.dev/" target="_blank" rel="noopener noreferrer">https://example.docsy.dev/</a> <ul> <li>comes from google. does not look that good.</li> </ul> </li> <li>other options <ul> <li>GitBook <ul> <li>limited theme (no dark mode)</li> <li>folder is a mess</li> <li>but it&rsquo;s simple to host</li> </ul> </li> <li>mkdoc-material <a href="https://github.com/squidfunk/mkdocs-material" target="_blank" rel="noopener noreferrer">https://github.com/squidfunk/mkdocs-material</a> <ul> <li>uses python, so build time will be long.</li> <li>config looks complicated.</li> </ul> </li> </ul> </li> </ul> </li> </ul>