From 6902af29eff9d273810bc7d220156912d25ba1ac Mon Sep 17 00:00:00 2001 From: Masataro Asai Date: Sun, 27 Oct 2019 12:40:45 -0400 Subject: [PATCH] [ci skip] [README] simplified / remove absolute url --- README.md | 58 +++++------------------------------------- docs/content-format.md | 26 +++++++++++++++++++ docs/deploy.md | 13 ++++++++++ 3 files changed, 45 insertions(+), 52 deletions(-) create mode 100644 docs/content-format.md create mode 100644 docs/deploy.md diff --git a/README.md b/README.md index e330f58..bee5a66 100644 --- a/README.md +++ b/README.md @@ -25,7 +25,8 @@ testing is primarily done on [SBCL](http://www.sbcl.org/) and [CCL](http://ccl.c * Git for storage * RSS/Atom feeds -* A [Plugin API](http://github.com/redline6561/coleslaw/blob/master/docs/plugin-api.md) and [**plugins**](http://github.com/redline6561/coleslaw/blob/master/docs/plugin-use.md) for... +* Themes +* A [Plugin API](docs/plugin-api.md) and [**plugins**](docs/plugin-use.md) for... | plugins | plugins | plugins | |--------------------------------------------------------|----------------------------------------------|-------------------------------------------------------| @@ -107,63 +108,16 @@ $ coleslaw watch-preview (coleslaw-cli:watch) ;; watch-preview does not work on REPL right now ``` -For further customization, edit the `.coleslawrc` file generated by `coleslaw setup`. -Consult the [config docs](https://github.com/redline6561/coleslaw/blob/master/docs/config.md). +For further customization, e.g. adding a new plugin, developing a new plugin, changing the deploy option, or creating a new theme, +see the [config docs](docs). -## The Content Format - -Coleslaw expects content to have a file extension matching the class -of the content. (I.e. `.post` for blog posts, `.page` for static pages, etc.) - -There should also be a metadata header on all files -starting and ending with the config-specified `:separator`, ";;;;;" by -default. Example: - -``` -;;;;; -title: foo -tags: bar, baz -date: yyyy-mm-dd hh:mm:ss -format: html (for raw html) or md (for markdown) -excerpt: Can also be extracted from content (see :excerpt-sep config param) -;;;;; -your post -``` - -Posts require the `title:` and `format:` fields. -Pages require the `title:` and `url:` fields. - -To omit a field, simply do not have the line present, empty lines and -fields (e.g. "tags:" followed by whitespace) will be ignored. - -## Theming - -Two themes are provided: hyde, the default, and readable (based on +We provide three default themes: hyde, the default, and readable (based on [bootswatch readable](http://bootswatch.com/readable/)). -A guide to creating themes for coleslaw lives -[here](https://github.com/redline6561/coleslaw/blob/master/docs/themes.md). - -## Deploying on a standalone server - -Coleslaw can deploy to a standalone server. -If you want this server installation, initialize a bare git repo and -set up the post-receive hook on that repo. - -* First initialize a [git bare repo](http://git-scm.com/book/en/Git-on-the-Server-Setting-Up-the-Server) on the server. -* Copy [example post-receive hook][post_hook] to your blog's bare repo and set the executable bit (`chmod +x`). - -* Point the web server at `:deploy-dir` attribute on the config file. - Or "deploy-dir/.curr" if the `versioned` plugin is enabled. - -[post_hook]: https://github.com/redline6561/coleslaw/blob/master/examples/example.post-receive - -## Hacking - A core goal of *coleslaw* is to be both pleasant to read and easy to hack on and extend. If you want to understand the internals and bend *coleslaw* to do new and interesting things, I strongly encourage you to read the [Hacker's Guide to Coleslaw][hackers]. You'll find some current **TODO** items towards the bottom. -[hackers]: https://github.com/redline6561/coleslaw/blob/master/docs/hacking.md +[hackers]: docs/hacking.md diff --git a/docs/content-format.md b/docs/content-format.md new file mode 100644 index 0000000..c48bab5 --- /dev/null +++ b/docs/content-format.md @@ -0,0 +1,26 @@ + +# The Content Format + +Coleslaw expects content to have a file extension matching the class +of the content. (I.e. `.post` for blog posts, `.page` for static pages, etc.) + +There should also be a metadata header on all files +starting and ending with the config-specified `:separator`, ";;;;;" by +default. Example: + +``` +;;;;; +title: foo +tags: bar, baz +date: yyyy-mm-dd hh:mm:ss +format: html (for raw html) or md (for markdown) +excerpt: Can also be extracted from content (see :excerpt-sep config param) +;;;;; +your post +``` + +Posts require the `title:` and `format:` fields. +Pages require the `title:` and `url:` fields. + +To omit a field, simply do not have the line present, empty lines and +fields (e.g. "tags:" followed by whitespace) will be ignored. diff --git a/docs/deploy.md b/docs/deploy.md new file mode 100644 index 0000000..3acecb1 --- /dev/null +++ b/docs/deploy.md @@ -0,0 +1,13 @@ +# Deploying on a standalone server + +Coleslaw can deploy to a standalone server. +If you want this server installation, initialize a bare git repo and +set up the post-receive hook on that repo. + +* First initialize a [git bare repo](http://git-scm.com/book/en/Git-on-the-Server-Setting-Up-the-Server) on the server. +* Copy [example post-receive hook][post_hook] to your blog's bare repo and set the executable bit (`chmod +x`). + +* Point the web server at `:deploy-dir` attribute on the config file. + Or "deploy-dir/.curr" if the `versioned` plugin is enabled. + +[post_hook]: https://github.com/redline6561/coleslaw/blob/master/examples/example.post-receive