X-Git-Url: https://git.korewanetadesu.com/?p=pelican-mode.git;a=blobdiff_plain;f=README.md;h=0869e4b1afd8d9d867802fff52d11f1affc75481;hp=ceec3d79a0d0a8f4cf33bf6163b4090c467610fc;hb=4dfce47d66561680157026878202ec60f81b4cee;hpb=c1a3b1044b0fc327ecfc2c5104a283201d7a0b7a diff --git a/README.md b/README.md index ceec3d7..0869e4b 100644 --- a/README.md +++ b/README.md @@ -1,9 +1,7 @@ -# pelican-mode - -pelican-mode is a minor mode for editing pages and posts in [Pelican] -sites. It's intended to be used alongside [markdown-mode] or -[rst-mode]. +pelican-mode is an Emacs minor mode for editing pages and posts in +[Pelican][] sites. +It's intended to be used alongside [markdown-mode][] or [rst-mode][]. It also assumes you've set up Pelican with `pelican-quickstart` or something like it. In particular it assumes: @@ -13,35 +11,41 @@ something like it. In particular it assumes: ancestor is irrelevant. * If the next component is `pages`, that indicates a static page rather than a dated post. - -It also enforces some parts of my preferred Pelican configuration: - * Categories are never provided (you can have one if you want, but - the default interactive commands don't provide one). - * Tags are always provided. - * Slugs are explicit, and include nested subdirectories. ## Quick Guide -* `C-x p n` - Insert a post or page header -* `C-x p p` - Remove draft status from a post (i.e. publish it) -* `C-x p t` - Update the date field in a post/page header -* `C-x p h` - Generate HTML output for a site (equivalent to `make html`) -* `C-x p u` - Upload a site using rsync (equivalent to `make rsync_upload`) +To enable by default on all text files in a Pelican site: + + (require 'pelican-mode) + (pelican-global-mode) + +Or, register `pelican-mode` or `pelican-mode-enable-if-site` +as hook functions for more direct control. + +* `C-c P d` - Update the document’s date +* `C-c P f` - Set a metadata field (title, category, etc.) +* `C-c P h` - Generate HTML output for a site (equivalent to `make html`) +* `C-c P n` - Insert a post or page header +* `C-c P p` - Remove draft status from a post (i.e. publish it) +* `C-c P u` - Upload a site using rsync (equivalent to `make rsync_upload`) + ## Troubleshooting If the commands which invoke `make` can find the Makefile but can't find `pelican`, your `exec-path` may not be set right. Try out -[exec-path-from-shell]. +[exec-path-from-shell][]. + ## License -This code is released into the public domain via the -[CC0 Public Domain Dedication][0]. +This program is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation, either version 3 of the License, or (at +your option) any later version. [Pelican]: http://getpelican.com/ [markdown-mode]: http://jblevins.org/projects/markdown-mode/ [rst-mode]: http://docutils.sourceforge.net/docs/user/emacs.html [exec-path-from-shell]: https://github.com/purcell/exec-path-from-shell - [0]: http://creativecommons.org/publicdomain/zero/1.0/legalcode