Commit 3351d442 authored by Marien Fressinaud's avatar Marien Fressinaud
Browse files

Add instructions in

Theme is now available at

parent b3deba18
......@@ -4,8 +4,87 @@ Content files for []( website. uses [Pelican]( as static site generator. It is a powerful Python software which generates HTML from Markdown or reStructuredText formats.
This repository only contains raw content (in Markdown) and does not host FreshRSS theme nor configuration files. Instructions to build FreshRSS website will come later in their own repository.
This repository only contains raw content (in Markdown) and does not host FreshRSS theme.
Actually, there is only one content file: `./pages/index.html`. Yes, it is HTML. It is the home page content of and is very specific.
The blog is not yet supported by FreshRSS Pelican theme so blog posts are not present yet. Blog posts will be written in Markdown under a `./blog` directory.
## Installation
We assume in this section you have Python 2.7+ installed on your system, with `pip` command and you work in a virtual environment (`virtualenv`, `pew` or similar).
First, install Pelican and the dependencies:
$ pip install pelican Markdown
Then, run `pelican-quickstart` command:
$ mkdir
$ cd
$ pelican-quickstart
Pelican will ask you some information. Here are what is suggested but you can adapt to your own case:
- Creation path: current path is ok
- Website title: FreshRSS, a free, self-hostable aggregator…
- Website author: Community
- Default language: en
- URL prefix: (or you can adapt)
- Articles per page (consider pagination is enabled): 10
- Generate Fabfile/Makefile: yes
- simpleHTTP script: yes
Finally, it will ask you which tools to use to upload your website: the choice is in your hands but SSH is recommended (it provides `scp` and `rsync` upload).
We have now to adapt configuration from the `./` file:
1. First, remove `LINKS` and `SOCIAL` information, we don't need of them
2. Next, you should add the following lines to the file:
SITESUBTITLE = 'A free, self-hostable aggregator… probably the best! <small>(in our opinion)</small>'
THEME = 'Freshican'
'extra/robots.txt': {'path': 'robots.txt'},
'extra/favicon.ico': {'path': 'favicon.ico'},
'extra/.htaccess': {'path': '.htaccess'},
ARTICLE_PATHS = ['blog']
# Specific to FreshRSS theme
<p>Made by <a href="">amazing contributors</a>.</p>
<p>Code licensed under <a href="">AGPL</a>.</p>
<p>Hosted by <a href="">OVH</a>.</p>
<p>This site uses <a href="">KNACSS</a> and <a href="">GNOME icons</a>.</p>
We have nearly finished! All we need now is the FreshRSS theme (Freshican) and... the content (this repository!).
$ git clone
$ git clone content
You should be able to start the development server and access the website (on http://localhost:8000) correctly:
$ ./ start
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment