vimwiki

commands

command description
= increase header
- decrease header
C-space check todo box
glh step down list
gll step up list
\w\t day diary in new tab
\w\i on diary index generate new links
\wt open wiki index in tab (only after mapping nmap <Leader>wt <Plug>VimwikiTabnewLink)
\wi open diary index

syntax highlighting

echo hello friend

convert to html

pandoc -s -f markdown -t html -o uofu/azure_ad_requirements.html uofu/azure_ad_requirements.md && firefox uofu/azure_ad_requirements .html

anchors

use title i'm using :tags: under a #ref header to jump to links in page

gollum

  • install gollum sudo gem install gollum
    • requires 'icu' sudo dnf install libicu-devel
  • navigate to wiki dir and run gollum gollum --css --h1-title
    • using custom css file and setting first h1 header as page title
    • see gollum config docs for options
  • look at omnigollum for user auth
  • gollum reverse proxy

installing gollum on jump-test

https://github.com/gollum/gollum # use --bare

steps

  • to enable git server
    • install git (duh!)
    • create 'git' user adduser git mkdir ~git/.ssh chmod 700 ~git/.ssh touch ~git/.ssh/authorized_keys chmod 600 ~git/.ssh/authorized_keys
  • mkdir 'wiki' dir mkdir /wiki chown git. /wiki
  • create git repo - getting git on server su - git cd /wiki git init --bare --shared
  • clone repo and initial commit (on local machine) git clone git@gitserver:/wiki wiki cd wiki/ echo "# wiki" > README.md git add README.md git commit -m "Initial commit" git push -u origin master

  • install gollum

    apt install ruby ruby-dev build-essential zlib1g-dev libicu-dev
gem install gollum

    yum group install "Development Tools"
yum install ruby ruby-devel libicu libicu-devel zlib zlib-devel
gem install gollum

  • enable gollum as a service

    vi /etc/systemd/system/gollum.service

[Service]
ExecStart=/usr/local/bin/gollum --show-all "/wiki"
  • allow traffic iptables -I INPUT -p tcp --dport 4567 -j ACCEPT -m comment --comment "Allow access to wiki"

ref