aboutsummaryrefslogtreecommitdiffstats
path: root/bootlex/README.md
diff options
context:
space:
mode:
authorAlexis Metaireau <alexis@notmyidea.org>2012-03-27 15:38:13 -0700
committerAlexis Metaireau <alexis@notmyidea.org>2012-03-27 15:38:13 -0700
commit51252efe985968fd564c9c68d2c94cf5182557f8 (patch)
treebfe151e0b0137e5431ba10d6a2a569ba57580064 /bootlex/README.md
parente38b06c659d60590c0000f2938387d7fa161e2e5 (diff)
parent7dc4d494bd4a5dc5f81a0d2819bdedbcba4367b5 (diff)
downloadpelican-themes-51252efe985968fd564c9c68d2c94cf5182557f8.tar.gz
Merge pull request #19 from alexex/master
added bootlex theme to the themes repo
Diffstat (limited to 'bootlex/README.md')
-rw-r--r--bootlex/README.md45
1 files changed, 45 insertions, 0 deletions
diff --git a/bootlex/README.md b/bootlex/README.md
new file mode 100644
index 0000000..0832e5e
--- /dev/null
+++ b/bootlex/README.md
@@ -0,0 +1,45 @@
+# What is bootlex?
+
+Bootlex is a theme for the [pelican](https://github.com/ametaireau/pelican) static blog generator.
+It is based on a modified bootstrap and works nicely with a lot of pelican features.
+
+# Requirements
+
+At some points I switched to the git version, so this theme might work with the stable version, but I recommend to use the latest version from git.
+
+# Installation
+
+Just pull the repo with `git clone git://github.com/alexex/bootlex.git` and include its location via the `THEME` option in your settings.py
+
+There are some settings that will make it work flawlessly:
+
+Your `SITEURL`must have a **trailing slash**. I would recommend the following url config, that I am using with my theme, and seems to work quite good:
+
+ ARTICLE_URL = ('{slug}/')
+ ARTICLE_SAVE_AS = ('{slug}.html')
+ PAGE_URL = ('{slug}/')
+ PAGE_SAVE_AS = ('{slug}.html')
+ AUTHOR_URL = ('author/{name}/')
+ TAG_URL = ('tag/{name}/')
+
+You will probably need some RewriteRules for your Webserver aswell, my `.htaccess` looks like this:
+
+ RewriteEngine On
+
+ RewriteBase /
+
+ RewriteCond %{REQUEST_FILENAME}.html -f
+ RewriteRule ^(.+)/$ $1.html [L]
+
+# Features
+
+You can make use of the following settings:
+
+* `Pages` (will be included in the menu automatically)
+* `MENUITEMS` (will be included aswell)
+* `LINKS` (as the above)
+* `GOOGLE_ANALYTICS` (will be included automatically, if set)
+
+# Missing
+
+I do not know whether it works, but as I never cared about it, I suppose that categorys will not work properly