2010-07-23 02:52:43 +02:00
|
|
|
INFO
|
|
|
|
====
|
|
|
|
|
|
|
|
fugitive is a blog engine running on top of git using hooks to generate static
|
|
|
|
html pages and thus having only git as dependency.
|
|
|
|
|
|
|
|
|
|
|
|
INSTALL
|
|
|
|
=======
|
|
|
|
|
2010-07-24 01:24:10 +02:00
|
|
|
Build
|
|
|
|
-----
|
|
|
|
If you want to build fugitive from the source, clone the git repository:
|
|
|
|
`git clone git://gitorious.org/fugitive/fugitive.git fugitive`
|
|
|
|
Then simply go in the newly created directory: `cd fugitive`, and run the build
|
|
|
|
script: `./build.sh`.
|
|
|
|
This will generate an executable file "fugitive".
|
|
|
|
|
|
|
|
Create a blog
|
|
|
|
-------------
|
|
|
|
If you have the "fugitive" executable file and want to start a new blog:
|
|
|
|
Run `fugitive --install <dir>`.
|
2010-07-23 02:52:43 +02:00
|
|
|
This will create the git repos with appropriate hooks and files in <dir>.
|
|
|
|
If <dir> isn't specified then the current working directory is used.
|
|
|
|
|
2010-07-24 01:24:10 +02:00
|
|
|
NOTE: You need to use the same process to install any remote repository where
|
|
|
|
you'd like to push your blog.
|
2010-07-23 02:52:43 +02:00
|
|
|
|
2010-07-24 01:24:10 +02:00
|
|
|
Update
|
|
|
|
------
|
2010-07-23 02:52:43 +02:00
|
|
|
Simply run `fugitive --install-hooks <dir>`.
|
|
|
|
This will only (re)install fugitive hooks scripts.
|
|
|
|
If <dir> isn't specified then the current working directory is used.
|
|
|
|
|
|
|
|
|
|
|
|
CONFIGURATION
|
|
|
|
=============
|
|
|
|
|
|
|
|
There are three item in the "fugitive" section of the git config:
|
|
|
|
|
|
|
|
- "public-dir" is the path to the directory that will contain the generated
|
|
|
|
html files. Defautlt value is ".", the root of the git repository. You
|
|
|
|
could set it to "blog" for instance if you already have a static website
|
|
|
|
under your git repos.
|
|
|
|
|
|
|
|
- "articles-dir" is the path where fugitive will look for published articles.
|
2010-07-24 01:24:10 +02:00
|
|
|
Default value is "_articles". This path is relative to the root of
|
2010-07-23 02:52:43 +02:00
|
|
|
the git repository, must be in it and must not start with ".".
|
|
|
|
|
|
|
|
- "templates-dir" is the path where fugitive will look for templates files.
|
2010-07-24 01:24:10 +02:00
|
|
|
Default value is "_templates". This path is relative to the root of
|
2010-07-23 02:52:43 +02:00
|
|
|
the git repository, must be in it and must not start with ".".
|
|
|
|
|
|
|
|
NOTE: You must NOT put a trailing '/' at the end of any of those paths.
|
|
|
|
|
|
|
|
|
|
|
|
USAGE
|
|
|
|
=====
|
|
|
|
|
|
|
|
General use
|
|
|
|
-----------
|
|
|
|
|
2010-07-23 11:54:08 +02:00
|
|
|
Article you want to publish should be file without the .html extension in the
|
|
|
|
"articles-dir" directory (see CONFIGURATION).
|
|
|
|
|
|
|
|
The first line of the file will be used as title and the rest of the file as
|
|
|
|
the content.
|
2010-07-23 02:52:43 +02:00
|
|
|
|
2010-07-23 14:55:45 +02:00
|
|
|
/!\ WARNING: DO NOT CREATE AN ARTICLE FILE NAMED "archives"
|
|
|
|
/!\ WARNING: DO NOT CREATE AN ARTICLE FILE NAMED "index"
|
|
|
|
|
2010-07-23 02:52:43 +02:00
|
|
|
Template system
|
|
|
|
---------------
|
2010-07-23 11:54:08 +02:00
|
|
|
*TODO*
|
2010-07-23 02:52:43 +02:00
|
|
|
|