Meta

Fundamentals

What is sexy?

  • Git backend
  • Wiki style
  • Markdown syntax
  • Confortable experience editing, navigating
    • my preferred editor (git)
    • a good interface (web)
      • wysiwyg editor

Tools that allow this

  • ikiwiki
    • problems: slow navigation, ugly interaction
  • gitit
    • vs ikiwiki: fast navigation, simple and effective interaction, easier to install
    • problem: no ACLs -> solution: multiple wikis
    • problem: manage users through multiple wikis -> solution (not easy): study auth methods available
  • mediawiki
    • wysiwyg editor (work in progress)
      • https://www.mediawiki.org/wiki/Extension:VisualEditor
      • https://github.com/wikimedia/mediawiki-extensions-VisualEditor
    • git (not tried)
      • https://www.mediawiki.org/wiki/Git_transclusion_in_MediaWiki
      • https://www.mediawiki.org/wiki/Git-remote-mediawiki
      • https://github.com/Git-Mediawiki/Git-Mediawiki/wiki

Useful resources

  • Pandoc tool to convert from markdown to lots of formats
  • Display as a book
    • gitbooks.io
    • Mdbook, alternative to gitbooks written in rust. src: https://github.com/azerupi/mdBook
  • Display as a website
    • mdwiki. src: http://dynalon.github.io/mdwiki/#!index.md
    • Hugo (?). src: https://gohugo.io/overview/introduction/
    • mkdocs. src: http://www.mkdocs.org/
    • markdoc. src: http://markdoc.org
    • export just a wiki page as print version in gitit
  • Display as a presentation (slides). Just a wiki page
    • remarkjs.com
    • export as slidy in gitit

Migrating moinmoin wiki of criptica to gitit?

https://ikiwiki.info/tips/convert_moinmoin_to_ikiwiki/

Alternative: find a way such that moinmoin works with fundamentals:

  • [ ] Git backend
  • [X] Wiki style
  • [ ] Markdown syntax

Hackable editors

  • Vim
    • neovim
  • Emacs
  • Atom (great for HTML/CSS/JS development)