forked from FG42/FG42
44 lines
1.5 KiB
Markdown
44 lines
1.5 KiB
Markdown
|
![Build Status](https://gitlab.com/pouya-abbassi/pouyacode/badges/master/build.svg)
|
||
|
|
||
|
---
|
||
|
|
||
|
[FG42](https://fg42.org) built using [Pelican](https://blog.getpelican.com) & [Bulma](https://bulma.io).
|
||
|
|
||
|
## Build
|
||
|
|
||
|
```
|
||
|
pip install -r requirements.txt
|
||
|
git clone git@github.com:getpelican/pelican-plugins.git
|
||
|
make publish
|
||
|
```
|
||
|
|
||
|
This will create `public` directory contaning all static files.
|
||
|
|
||
|
## Email Obfuscation
|
||
|
I use [ROT13](https://en.wikipedia.org/wiki/ROT13) to obfuscate email adresses.
|
||
|
So email adresses that would be visible to users should be generated using this command (or similar tools):
|
||
|
|
||
|
```
|
||
|
echo "pcode@protonmail.com" | tr 'A-Za-z' 'N-ZA-Mn-za-m'
|
||
|
#or
|
||
|
tr 'A-Za-z' 'N-ZA-Mn-za-m' <<< "pcode@protonmail.com"
|
||
|
```
|
||
|
|
||
|
They are then processed on user's browser using a simple js function.
|
||
|
|
||
|
## Sample Pages
|
||
|
There is a sample page at `content/docs.md` that has a metadata `status: hidden`.
|
||
|
Remove this metadata to see it in the index page. This page is just for demo purpose.
|
||
|
|
||
|
Also there are two pages inside `content/pages/` directory with metadata `error: true`.
|
||
|
This makes the background to stretch and fill the page.
|
||
|
The `content/pages/release-notes.md` is also just for demo purpose.
|
||
|
|
||
|
## Images
|
||
|
Images for articles and pages should be stored at `theme/static/images/articles/` and `theme/static/images/pages/` directory.
|
||
|
These images should be named after their page title so it would be easier to manage.
|
||
|
|
||
|
## Configs
|
||
|
Development config file is `pelicanconf.py` and the deployment config file is `publishconf.py`.
|
||
|
`SITEURL` and `PLUGINS` are two most important lines of those files.
|