The $\href{https://kodama-community.github.io/}{\includegraphics[height=0.7em, totalheight=0.7em, width=0.755em, alt=logo]{/assets/kodama.svg} ~ \color{fe7f7e}\text{Kodama}}$ Project [index]

1. Is there any software like that? [aslt]

    $\gdef\latex{\href{https://www.latex-project.org/}{\color{#008080}\LaTeX}}$

    $\gdef\gerby{\href{https://gerby-project.github.io/}{\color{#c5000c} \text{Gerby}}}$

    $\gdef\katex{\href{https://katex.org/}{\color{#329894} \KaTeX}}$

    $\gdef\obsidian{\href{https://obsidian.md/}{\color{#a78bfa} \text{Obsidian}}}$

    $\gdef\forester{\href{https://www.forester-notes.org/index/index.xml}{\color{#00B770} \text{Forester}}}$

    $\gdef\typst{\href{https://typst.app/}{\color{#239dad} \text{Typst}}}$

    • $\obsidian$ looks great and has a rich ecosystem of community plugins, but I’d really prefer if it could:

      • Not break the rendering of normal $\katex$ formulas I write.
      • Support drawing non-rectangular commutative diagrams.
      • Provide theorem environments or something similar.
      • Be lightweight — my disk space is running dangerously low from all the Electron-based apps I’ve already installed.
      • Work well on mobile devices with the help of a terminal emulator like Termux.

    • $\forester$ looks great, but …

      • I’d prefer to write in Markdown and $\typst$.
      • I want an out-of-the-box dark theme, and vector graphics rendered by the application should also have their colors properly adjusted.
      • I’d like a table of contents that’s always available, even on small-screen devices.

    • $\gerby$ looks great, but …

      • I don’t intend to write in $\latex$.
      • I can’t fully accept the tag system.

    2. Frequently asked questions [faq]

      FAQ 2.1. Is this project stable yet? [stable]

        $\gdef\kodama{\href{https://kodama-community.github.io/}{\includegraphics[height=0.7em, totalheight=0.7em, width=0.755em, alt=logo]{/assets/kodama.svg} ~ \color{fe7f7e}\text{Kodama}}}$

        Not yet. Although $\kodama$ already has quite a few features and some early adopters, it’s still in a very early stage, and breaking changes may be introduced with every release. That said, this could also be a good thing — it means many design decisions haven’t been finalized, so anyone can share ideas and actively contribute to shaping $\kodama$’s design.

        FAQ 2.2. Is this just a static site generator? [ssg]

          Almost, but it doesn’t actually prevent users from adding dynamic content. Currently, we’ve simply moved some of the dynamic features typically found in wiki-like systems into the compile phase.

          FAQ 2.3. What motivated you to develop $\href{https://kodama-community.github.io/}{\includegraphics[height=0.7em, totalheight=0.7em, width=0.755em, alt=logo]{/assets/kodama.svg} ~ \color{fe7f7e}\text{Kodama}}$? [motive]

            $\gdef\latex{\href{https://www.latex-project.org/}{\color{#008080}\LaTeX}}$

            $\gdef\katex{\href{https://katex.org/}{\color{#329894} \KaTeX}}$

            $\gdef\forester{\href{https://www.forester-notes.org/index/index.xml}{\color{#00B770} \text{Forester}}}$

            $\gdef\typst{\href{https://typst.app/}{\color{#239dad} \text{Typst}}}$

            $\gdef\kodama{\href{https://kodama-community.github.io/}{\includegraphics[height=0.7em, totalheight=0.7em, width=0.755em, alt=logo]{/assets/kodama.svg} ~ \color{fe7f7e}\text{Kodama}}}$

            The original motivation for the $\kodama$ project was to create a static blog engine that truly satisfied my needs, similar to what Hexo, Hugo, Zola and others do.

            • Unfortunately, for various reasons, these static site generators (SSGs) all have issues when it comes to mathematical writing, which severely limits expressive power. This frustration persisted until I discovered $\forester$ and $\typst$.

            • I believe $\forester$ can meet the complex demands of mathematical writing, but if I wanted to migrate my old blog posts, I’d have to completely rewrite them. Another factor was LaTeX’s slow compilation speed and suboptimal editing experience. So, I decided to replace $\forester$’s $\katex$ + $\latex$ scheme with $\katex$ + $\typst$.

            • There’s also a smaller, yet still important, reason: I wanted a fully automatic dark theme that just works out-of-the-box.

            FAQ 2.4. What kind of animal is this? [mascot]

              Chinese hwamei. Ouyang Xiu, a literary figure of the Northern Song dynasty, wrote a Qiyan Jueju titled “The Hwamei Bird” to celebrate the spirit of freedom.

              $$ \small \begin{array}{cc} \sf 百啭千声随意移 & \sf 山花红紫树高低 \\ \sf 始知锁向金笼听 & \sf 不及林间自在啼 \end{array} $$