summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorDavid Luevano Alvarado <david@luevano.xyz>2021-05-17 13:56:11 -0600
committerDavid Luevano Alvarado <david@luevano.xyz>2021-05-17 13:56:11 -0600
commit8f04b57f1adff758e74c255e448f8e2e9e861982 (patch)
treee3fcff2ce1691d0a5b71a1fffe598fa4f240d01f /README.md
parent0dae5d53c49dd7b946990ca9e232fb924bf4f918 (diff)
clean up and update readmev0.2.0
Diffstat (limited to 'README.md')
-rw-r--r--README.md42
1 files changed, 41 insertions, 1 deletions
diff --git a/README.md b/README.md
index 88849bf..5d6c209 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,45 @@
# pyssg
-Static Site Generator inspired by Roman Zolotarev's [ssg5](https://rgz.ee/bin/ssg5) and [rssg](https://rgz.ee/bin/rssg) Luke Smith's [lb and sup](https://github.com/LukeSmithxyz/lb) and, pedantic.software's [blogit](https://pedantic.software/git/blogit/).
+Static Site Generator inspired by Roman Zolotarev's [`ssg5`](https://rgz.ee/bin/ssg5) and [`rssg`](https://rgz.ee/bin/rssg), Luke Smith's [`lb` and `sup`](https://github.com/LukeSmithxyz/lb) and, pedantic.software's [`blogit`](https://pedantic.software/git/blogit/).
The reason of making this in python is because I was tired of wanting (some) features from all of these minimal programs, but being a pain in the ass to maintain or add features on my own, specially to `blogit`...; making minimalist software it's great and all, but there is a limit on how pretentious and elitist a software can be for me to accept it.
+
+## Current features
+
+This is still a WIP. Still doesn't build `sitemap.xml` or `rss.xml` files.
+
+- [x] Build static site parsing `markdown` files ( `*.md` -> `*.html`)
+ - [x] Preserves hand-made `*.html` files.
+ - [x] Tag functionality.
+ - [ ] Open Graph (and similar) support.
+- [ ] Build `sitemap.xml` file.
+- [ ] Build `rss.xml` file.
+
+## Markdown features
+
+This program uses [`python-markdown`](https://python-markdown.github.io/) package with the following [extensions](https://python-markdown.github.io/extensions/):
+
+- Extra (collection of QoL extensions).
+- Meta-Data.
+- Sane Lists.
+- SmartyPants.
+- Table of Contents.
+- WikiLinks.
+
+## Usage
+
+First initialize the directories you're going to use for the source files and destination files:
+
+```sh
+pyssg -s src_dir -d dst_dir -i
+```
+
+That creates the desired directories with the basic templates that can be edited as desired. Place your `*.md` files somewhere inside the source directory (`src_dir` in the command above), but outside of the `templates` directory. It accepts sub-directories.
+
+Build the site with:
+
+```sh
+pyssg -s src_dir -d dst_dir -u https://baseurl.com -b
+```
+
+Without a trailing slash `/` at the end of the base URL. That creates all `*.html` for the site and can be easily moved to the server.