https://arthurheymans.github.io/hugo-emacs-theme/Recent content on Emacs Theme DemoHugoen-usMon, 15 Jan 2024 00:00:00 +0000https://arthurheymans.github.io/hugo-emacs-theme/posts/welcome-to-emacs-theme/Mon, 15 Jan 2024 00:00:00 +0000https://arthurheymans.github.io/hugo-emacs-theme/posts/welcome-to-emacs-theme/<p>Welcome to the Emacs Hugo theme! This theme transforms your Hugo blog into an authentic Emacs-like experience.</p> <h2 id="getting-started">Getting Started</h2> <p>Try these keyboard shortcuts:</p> <ul> <li>Press <code>n</code> and <code>p</code> to navigate between articles</li> <li>Press <code>RET</code> or <code>o</code> to open an article</li> <li>Press <code>q</code> to go back to the list</li> <li>Press <code>t</code> to toggle between dark and light themes</li> <li>Press <code>?</code> to see all available shortcuts</li> </ul> <h2 id="window-management">Window Management</h2> <p>Just like in Emacs, you can split your view:</p>https://arthurheymans.github.io/hugo-emacs-theme/posts/keyboard-navigation/Sun, 14 Jan 2024 00:00:00 +0000https://arthurheymans.github.io/hugo-emacs-theme/posts/keyboard-navigation/<p>One of the key features of this theme is comprehensive keyboard navigation, inspired by Emacs keybindings.</p> <h2 id="philosophy">Philosophy</h2> <p>Emacs users know the power of keeping your hands on the keyboard. This theme brings that same efficiency to your blog reading experience.</p> <h2 id="navigation-keys">Navigation Keys</h2> <h3 id="in-the-article-list">In the Article List</h3> <table> <thead> <tr> <th>Key</th> <th>Action</th> </tr> </thead> <tbody> <tr> <td><code>n</code> / <code>↓</code></td> <td>Move to next article</td> </tr> <tr> <td><code>p</code> / <code>↑</code></td> <td>Move to previous article</td> </tr> <tr> <td><code>RET</code> / <code>o</code></td> <td>Open selected article</td> </tr> <tr> <td><code>&lt;</code></td> <td>Jump to first article</td> </tr> <tr> <td><code>&gt;</code></td> <td>Jump to last article</td> </tr> </tbody> </table> <h3 id="in-an-article">In an Article</h3> <table> <thead> <tr> <th>Key</th> <th>Action</th> </tr> </thead> <tbody> <tr> <td><code>n</code> / <code>p</code></td> <td>Scroll or navigate (context-dependent)</td> </tr> <tr> <td><code>SPC</code></td> <td>Page down</td> </tr> <tr> <td><code>S-SPC</code></td> <td>Page up</td> </tr> <tr> <td><code>C-v</code> / <code>M-v</code></td> <td>Page down / up (Emacs style)</td> </tr> <tr> <td><code>&lt;</code> / <code>&gt;</code></td> <td>Beginning / end of article</td> </tr> <tr> <td><code>q</code></td> <td>Return to list</td> </tr> </tbody> </table> <h2 id="tips">Tips</h2> <ol> <li><strong>Split view</strong>: Use <code>C-x 3</code> to read articles while keeping the list visible</li> <li><strong>Quick switching</strong>: <code>Tab</code> or <code>C-x o</code> switches between windows</li> <li><strong>Theme toggle</strong>: Press <code>t</code> anytime to switch between dark and light modes</li> <li><strong>Font size</strong>: Use <code>+</code> and <code>-</code> to adjust text size</li> </ol>https://arthurheymans.github.io/hugo-emacs-theme/posts/modus-themes/Sat, 13 Jan 2024 00:00:00 +0000https://arthurheymans.github.io/hugo-emacs-theme/posts/modus-themes/<p>This theme uses color schemes based on the <a href="https://protesilaos.com/emacs/modus-themes">Modus Themes</a> by Protesilaos Stavrou.</p> <h2 id="why-modus">Why Modus?</h2> <p>Modus themes are designed with accessibility in mind. They conform to the highest standard for color contrast (WCAG AAA), making them:</p> <ul> <li>Easy on the eyes for extended reading</li> <li>Accessible to users with visual impairments</li> <li>Consistent across different displays</li> </ul> <h2 id="two-variants">Two Variants</h2> <h3 id="modus-vivendi-dark">Modus Vivendi (Dark)</h3> <p>The default dark theme features a deep background with carefully selected foreground colors that maintain excellent contrast without being harsh.</p>https://arthurheymans.github.io/hugo-emacs-theme/posts/customization/Fri, 12 Jan 2024 00:00:00 +0000https://arthurheymans.github.io/hugo-emacs-theme/posts/customization/<p>The Emacs Hugo theme is designed to be easily customizable while maintaining its authentic Emacs look and feel.</p> <h2 id="fonts">Fonts</h2> <p>The theme ships with <a href="https://github.com/tonsky/FiraCode">Fira Code</a>, a popular monospace font with programming ligatures.</p> <p>To use a different font:</p> <ol> <li>Add your font files to <code>static/fonts/</code></li> <li>Update the <code>@font-face</code> declarations in <code>assets/css/main.css</code></li> <li>Change the <code>font-family</code> property</li> </ol> <h2 id="colors">Colors</h2> <p>All colors are defined as CSS custom properties in <code>assets/css/themes.css</code>. The main variables include:</p> <ul> <li><code>--bg-main</code> - Primary background</li> <li><code>--fg-main</code> - Primary foreground (text)</li> <li><code>--bg-active</code> - Active/selected items</li> <li><code>--border-color</code> - Window borders</li> </ul> <h2 id="modeline">Modeline</h2> <p>The modeline at the bottom of each buffer shows:</p>