setting up nikola / org-mode

Frankie Liu

installing nikola

conda activate
pip install Nikola[extras]
nikola version

get a site up and running

nikola init mysite
cd mysite
nikola new_post
nikola build
nikola serve -b
# nikola auto --browser

adding org support

nikola new_post -F
nikola plugin -i orgmode
emacs conf.py
echo <<EOF
# add the following lines

Contents of the conf.py.sample file:

# NOTE: Needs additional configuration in init.el file.

# Add the orgmode compiler to your COMPILERS dict.
COMPILERS["orgmode"] = ('.org',)

# Add org files to your POSTS, PAGES
POSTS = POSTS + (("posts/*.org", "posts", "post.tmpl"),)
PAGES = PAGES + (("pages/*.org", "pages", "page.tmpl"),)
EOF
nikola new_post -f orgmode
nikola build
nikola serve -b

adding math support

add a field in the preamble, has_math: true

adding code

it shoud work out of the box

deploying on github.io

By default nikola works off from the src branch and output goes to the master branch.

Also you need to add the following under files/CNAME:

www.frankliu.org

This is the name from the domain provider. Also configure the repository settings: go under settings, and modify the custom domain field to

www.frankliu.org.

Finally from nikola in the src branch you can:

nikola github_deploy

This will create a new/or modify the existing branch master where the generated pages will reside.