Nikola - Revision history

Elvince: nikola.el

2017-02-21T13:50:39Z

nikola.el

Elvince: post with org mode

2014-09-26T13:41:41Z

post with org mode

Elvince: god damn it, org2nikola does exist !

2014-08-13T13:23:13Z

god damn it, org2nikola does exist !

Elvince: adding category

2014-08-11T10:49:18Z

adding category

Elvince: nikola and org workflow

2014-08-11T10:47:41Z

nikola and org workflow

New page

'''Nikola''' is a static site generator, written in Python. It natively supports RestructuredText or Markdown, and it is also possible to write with orgmode thanks to a plugin.

Once you have [http://getnikola.com/ setup your Nikola site], install the plugin with "nikola plugin -i orgmode" and add this in your config.py:

# 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 + (("stories/*.org", "posts", "post.tmpl"),)

Now add Nikola's header in a comment block at the top of your new post:

#+BEGIN_COMMENT
.. title: a title
.. slug: a-title
.. date: 2014-08-07 10:57:15 UTC-04:00
.. tags: one, two
.. link:
.. description:
.. type: text
#+END_COMMENT

You can now write a blog post using orgmode and Nikola.

← Older revision		Revision as of 13:50, 21 February 2017
Line 1:		Line 1:
	'''Nikola''' is a static site generator, written in Python. It natively supports RestructuredText or Markdown, and it is also possible to write with orgmode thanks to a plugin.		'''Nikola''' is a static site generator, written in Python. It natively supports RestructuredText or Markdown, and it is also possible to write with orgmode thanks to a plugin.
		+
		+	= Nikola.el =
		+
		+	[https://git.daemons.cf/drymer/nikola.el Nikola.el] is a wrapper around Nikola commands, allowing to create posts, run or publish your site from emacs.
		+
		+	To write with org-mode, we still need org2nikola (see below).

	= Install nikola's org plugin =		= Install nikola's org plugin =

@@ Line 3: / Line 3: @@
 = Install nikola's org plugin =
-Once you have [http://getnikola.com/  setup your Nikola site], install the plugin with "nikola plugin -i orgmode" and add this in your config.py:
+Once you have [http://getnikola.com/  setup your Nikola site], install the plugin with
      # Add the orgmode compiler to your COMPILERS dict.
@@ Line 31: / Line 35: @@
 '''org2nikola''' ([https://github.com/redguardtoo/org2nikola github]) is a little package (much inspired by [[org2blog]]) that allows to post a subtree from within your org file.
-Install it with packages.el (via [[MELPA]]), put the cursor in the subtree you want to publish and call '''M-x org2nikola-export-subtree'''. It is the only command currently available.
+Install it with packages.el (via [[MELPA]]), put the cursor in the subtree you want to publish and call '''M-x org2nikola-export-subtree'''. It is the only command currently available. A drawback is that it publishes the post as html with a ".wp" extension, not in the org format (which is good for people coming from wordpress).
 [[Category:Blog]]

← Older revision		Revision as of 10:49, 11 August 2014
Line 22:		Line 22:

	You can now write a blog post using orgmode and Nikola.		You can now write a blog post using orgmode and Nikola.
		+
		+	[[Category:Blog]]

@@ Line 1: / Line 1: @@
 '''Nikola''' is a static site generator, written in Python. It natively supports RestructuredText or Markdown, and it is also possible to write with orgmode thanks to a plugin.
 Once you have [http://getnikola.com/  setup your Nikola site], install the plugin with "nikola plugin -i orgmode" and add this in your config.py:
@@ Line 8: / Line 10: @@
      POSTS = POSTS + (("posts/*.org", "posts", "post.tmpl"),)
      PAGES = PAGES + (("stories/*.org", "posts", "post.tmpl"),)
 Now add Nikola's header in a comment block at the top of your new post:
@@ Line 22: / Line 26: @@
 You can now write a blog post using orgmode and Nikola.
 [[Category:Blog]]