fix readme
This commit is contained in:
parent
44b08ee5e0
commit
64f37b7a03
|
|
@ -41,7 +41,7 @@ Attention: GSL aura besoin de créer des sous-dossier dans le serveur,
|
||||||
renseigné dans le questionnaire. (i.e. /var/www/). Il faut donc lui
|
renseigné dans le questionnaire. (i.e. /var/www/). Il faut donc lui
|
||||||
donner les droits
|
donner les droits
|
||||||
|
|
||||||
``
|
```
|
||||||
$ gsl new) domain
|
$ gsl new) domain
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,299 +0,0 @@
|
||||||
# GSL: Statique Littérateur
|
|
||||||
------------------------------------------------------------------------
|
|
||||||
|
|
||||||
GSL is a multiple blogs/websites generator based on their domain,
|
|
||||||
written in bash, for minimal dependancies. The websites are nearly all
|
|
||||||
static, except for some includes pages, like listing posts, that nginx
|
|
||||||
can easily get, in your webserver.
|
|
||||||
|
|
||||||
# Dependancies
|
|
||||||
------------------------------------------------------------------------
|
|
||||||
|
|
||||||
- bash
|
|
||||||
- coreutils
|
|
||||||
- curl (to check Posts links response)
|
|
||||||
- rsync
|
|
||||||
|
|
||||||
|
|
||||||
# GSL: Installation
|
|
||||||
------------------------------------------------------------------------
|
|
||||||
In your System /
|
|
||||||
```
|
|
||||||
git clone URL .
|
|
||||||
```
|
|
||||||
|
|
||||||
GSL does NOT use any sudo. To avoid errors, you must give permissions
|
|
||||||
to USER with chown -R to folders.
|
|
||||||
|
|
||||||
## --Prefix for DOMAIN configuration (set according to user choice):
|
|
||||||
- HOME: ~/.config/gsl
|
|
||||||
- GLOBAL: /var/lib/gsl
|
|
||||||
- Folder: --Prefix/domains/ (created with $ gsl new)
|
|
||||||
|
|
||||||
### DOMAIN Datas from Prefix:
|
|
||||||
- Folder: --Prefix/DOMAIN/ (Created by GSL)
|
|
||||||
- - Files: DOMAIN.conf, authors.db (Created by GSL)
|
|
||||||
- - Folder: --Prefix/DOMAIN/templates/ (css, logos...) (Created by GSL)
|
|
||||||
|
|
||||||
## Destination Folder: /etc/gsl/
|
|
||||||
- File: gsl.conf
|
|
||||||
|
|
||||||
## Destination Folder: /var/lib/gsl/
|
|
||||||
- Folder: db (Created by GSL)
|
|
||||||
- Folder: helps
|
|
||||||
- Folder: scripts
|
|
||||||
- File: README.md
|
|
||||||
|
|
||||||
## Destination Folder: /var/log/gsl
|
|
||||||
- File: gsl.log (Created and managed by GSL $ gsl log clean...)
|
|
||||||
|
|
||||||
## Destination Folder: /usr/local/bin
|
|
||||||
- File: gsl
|
|
||||||
|
|
||||||
## Destination Folder: /usr/share/bash-completion/completions/gsl
|
|
||||||
- File: gsl
|
|
||||||
|
|
||||||
# How to configure a DOMAIN folder, and create a Post
|
|
||||||
------------------------------------------------------------------------
|
|
||||||
|
|
||||||
When Adding a DOMAIN (example.com), GSL will ask you some questions.
|
|
||||||
Datas will be used to create a DOMAIN.conf file. GSL will also ask you
|
|
||||||
to set a folder where you will put your Posts, but you can create or add
|
|
||||||
ones too.
|
|
||||||
|
|
||||||
## Set a DOMAIN
|
|
||||||
- add a DOMAIN name (if not alrady done)
|
|
||||||
```
|
|
||||||
gsl new
|
|
||||||
```
|
|
||||||
|
|
||||||
Follow instructions when adding DOMAIN or see them again with
|
|
||||||
```
|
|
||||||
gsl help new
|
|
||||||
gsl help install
|
|
||||||
```
|
|
||||||
|
|
||||||
## Set a DOMAIN folder for Posts (if not already done by GSL or You)
|
|
||||||
|
|
||||||
- Add/Create or go into your folder of choice
|
|
||||||
- Save into that folder a blank file named gsl.DOMAIN (gsl.example.org)
|
|
||||||
so that GSL, knows this folder is for this DOMAIN website.
|
|
||||||
|
|
||||||
## Create a new Post
|
|
||||||
The engine is written from scratch and looks like a mix of markdown and
|
|
||||||
ReStructuredText. It's very easy to learn and use.
|
|
||||||
|
|
||||||
- Write a post in a file, using some "metas" that GSL will catch.
|
|
||||||
- Save your file with .gsl extension
|
|
||||||
- Start checking it, using:
|
|
||||||
|
|
||||||
```
|
|
||||||
gsl check
|
|
||||||
```
|
|
||||||
|
|
||||||
## Convert one or all Posts
|
|
||||||
If your Post has no error, you will have to deploy html
|
|
||||||
files and folders. You could install nginx, or lightweight darkhttpd
|
|
||||||
webserver on your PC to preview the website. You can also just open
|
|
||||||
index.html in your server folder, but you won't be able to see some extra
|
|
||||||
includes page, like Posts listing.
|
|
||||||
|
|
||||||
To convert your Posts in HTML, use
|
|
||||||
|
|
||||||
```
|
|
||||||
gsl make
|
|
||||||
```
|
|
||||||
|
|
||||||
You can select a specific post, with autocompletion to check and make
|
|
||||||
only that specified one.
|
|
||||||
|
|
||||||
# Create a Templates
|
|
||||||
------------------------------------------------------------------------
|
|
||||||
|
|
||||||
You will have to create some CSS (styles.css) in your /DOMAIN/templates/
|
|
||||||
- HOME: ~/.config/gsl/domains/DOMAIN/templates/
|
|
||||||
- GLOBAL: /var/lib/gsl/domains/DOMAIN/templates/
|
|
||||||
|
|
||||||
# How to Write a Post
|
|
||||||
------------------------------------------------------------------------
|
|
||||||
|
|
||||||
Post has 2 sections : Before and After #1. #1 is the FIRST Title of your
|
|
||||||
post. #(1-6) are HTML titles.
|
|
||||||
- Before #1 is used to set METAs HEADERS to configure your Post.
|
|
||||||
- From #1 is the CONTENT of your Post
|
|
||||||
|
|
||||||
## NEEDED HEADERS (before #1)
|
|
||||||
Register METAs for HTML Page content
|
|
||||||
|
|
||||||
```
|
|
||||||
title: POST TITLE
|
|
||||||
slug: POST-TITLE (if space in slug GSL will convert them)
|
|
||||||
info: DESCRIPTION (about the Post)
|
|
||||||
author: NAME (must be registred ($ gsl author add)
|
|
||||||
date: YYYY-MM-DD
|
|
||||||
tags: TAG1,OTHER TAG2,TAG3 (comma separated)
|
|
||||||
```
|
|
||||||
|
|
||||||
### Admin Header
|
|
||||||
Admin can define specific type of content. If no type defined, GSL will
|
|
||||||
add at first line the default value: "type: post".
|
|
||||||
|
|
||||||
TYPE:
|
|
||||||
- post < classic content
|
|
||||||
- page < used to define main index, 404, about...
|
|
||||||
|
|
||||||
```
|
|
||||||
type: TYPE
|
|
||||||
```
|
|
||||||
|
|
||||||
GSL will create html file according to slug. Do not add .html to slug.
|
|
||||||
- post < /slug/index.html
|
|
||||||
- page < /slug.html
|
|
||||||
|
|
||||||
## Optional HEADERS (before #1)
|
|
||||||
Register METAs for CONTENT. " : " field separator
|
|
||||||
|
|
||||||
```
|
|
||||||
abbr: SHORT : LONG
|
|
||||||
file: NAME : FILENAME : Alt Text
|
|
||||||
link: NAME : URL : Alt Text
|
|
||||||
code: NBR : FILENAME : Alt Text
|
|
||||||
image: NBR : FILENAME : ALT-TEXT
|
|
||||||
```
|
|
||||||
|
|
||||||
## CONTENT Post:
|
|
||||||
In Content Post, markers (i.e. __My Great file) must be on the SAME line.
|
|
||||||
For ABBRs, just write SHORT in your content
|
|
||||||
|
|
||||||
```
|
|
||||||
# Paragraphs
|
|
||||||
At begining of new line, open with ( and close with )
|
|
||||||
Set till 3 different classes with ( 1 ( 2 ( 3
|
|
||||||
( 2
|
|
||||||
This is a paragraph with class 2
|
|
||||||
)
|
|
||||||
|
|
||||||
# Register in Header. link: My Great Link : URL : Alt text
|
|
||||||
_My Great Link
|
|
||||||
_My Great Link+ # Open in new tab
|
|
||||||
|
|
||||||
# Register in Header. file: My Great file : FILENAME : ALT-TEXT
|
|
||||||
__My Great file
|
|
||||||
|
|
||||||
# Register in Header. image: 1 : FILENAME : ALT-TEXT
|
|
||||||
_image:1:[OPT l|r|c (left, right, center, alignment)]
|
|
||||||
_image:1:r
|
|
||||||
|
|
||||||
# Block-Code File: Register in Header. code: 1 : FILENAME : Alt Text
|
|
||||||
_code:1
|
|
||||||
|
|
||||||
# Write in STRONG
|
|
||||||
**this strong content**
|
|
||||||
this un**believe**able content
|
|
||||||
this border**line** content
|
|
||||||
|
|
||||||
# BOLD
|
|
||||||
*this bold content*
|
|
||||||
...
|
|
||||||
|
|
||||||
# Write in ITALIC
|
|
||||||
/this em text/
|
|
||||||
|
|
||||||
# Inline-code (¤ = alt-gr + $ on FR keyboard)
|
|
||||||
¤push()¤
|
|
||||||
|
|
||||||
# Simple Blockquote: Use 3 "-"
|
|
||||||
---
|
|
||||||
(
|
|
||||||
A simple great quote
|
|
||||||
)
|
|
||||||
---
|
|
||||||
|
|
||||||
# Advanced Blockquote
|
|
||||||
---
|
|
||||||
_cite : Richard Matthew Stallman
|
|
||||||
_link : https://stallman.org/
|
|
||||||
_lang : en
|
|
||||||
(
|
|
||||||
In the free/libre software movement, we develop software that respects
|
|
||||||
users' freedom, so we and you can escape from software that doesn't. I
|
|
||||||
could have made money this way, and perhaps amused myself writing code.
|
|
||||||
But I knew that at the end of my career, I would look back on years of
|
|
||||||
building walls to divide people, and feel I had spent my life making the
|
|
||||||
world a worse place
|
|
||||||
)
|
|
||||||
---
|
|
||||||
|
|
||||||
# For advanced blockquotes, you can also add, if known:
|
|
||||||
_year: 2021
|
|
||||||
_book: Esperanza 64
|
|
||||||
|
|
||||||
# Create Lists
|
|
||||||
Use = to create an item. You can use infinite sub-items, but each Item
|
|
||||||
of a list MUST be on the same Line
|
|
||||||
(
|
|
||||||
Let's start a list
|
|
||||||
= Item 1 is *great*
|
|
||||||
== sub-item 1
|
|
||||||
== sub-item 2
|
|
||||||
=== sub-sub-item 1 of sub-item 2
|
|
||||||
== sub-item 3
|
|
||||||
= Item 2
|
|
||||||
== sub-item 1 of Item 2
|
|
||||||
This list is ended
|
|
||||||
)
|
|
||||||
```
|
|
||||||
|
|
||||||
# HELP COMMAND
|
|
||||||
```
|
|
||||||
$ gsl [ARG]
|
|
||||||
readme : Show README.md instructions
|
|
||||||
help | -h [OPT] : This Help
|
|
||||||
install : Show process installation
|
|
||||||
new : Adding a DOMAIN
|
|
||||||
write | -w : How to write a Post
|
|
||||||
|
|
||||||
new | -N : Add and configure a new DOMAIN
|
|
||||||
|
|
||||||
log | -L [OPTS] : Show logs from all sessions
|
|
||||||
clean | -C : Logs saved to {DATE}.gsl.log and cleaned
|
|
||||||
-i | -w | -e : from levels (infos, warnings, errors)
|
|
||||||
-s : from last session only
|
|
||||||
[TERM] : [TERM] : case insensitive, regex 'T1.*T2'
|
|
||||||
(i.e. $ gsl log -e -s code)
|
|
||||||
|
|
||||||
author | -A [OPT] : List authors from DOMAIN set in PWD folder
|
|
||||||
add : Add author(s) for DOMAIN
|
|
||||||
remove : Remove author(s) for DOMAIN
|
|
||||||
|
|
||||||
edit | -E [FILE] : Open in default EDITOR [FILE] or with nano
|
|
||||||
db [FILE] : Show DB statuses from [FILE]
|
|
||||||
|
|
||||||
sync [OPT] : Sync Templates to www and wip
|
|
||||||
wip : Only to wip server (also done with make)
|
|
||||||
www : Only to www server (also done with www)
|
|
||||||
|
|
||||||
|
|
||||||
check | -C [OPT] [FILE] : Check Posts errors from PWD folder or [FILE]
|
|
||||||
-F : Force check again
|
|
||||||
|
|
||||||
make | -M [OPT] [FILE] : Convert Posts from PWD folder or [FILE]
|
|
||||||
to HTML file in server
|
|
||||||
-F : Force Make again
|
|
||||||
|
|
||||||
post-list [OPT] [FILE] : Add post again from [FILE] to Last-Posts List
|
|
||||||
(When converting new post, it will be added)
|
|
||||||
Pin : Set Post from [FILE] to first in Last-Posts List
|
|
||||||
Add : Add Post from [FILE] to last in Last-Posts List
|
|
||||||
|
|
||||||
www [OPT1] [OPT2] : Add/Remove Post from www server
|
|
||||||
[OPT1]:
|
|
||||||
add : Add all/[FILE] to www server
|
|
||||||
rmove : remove all/[FILE] from www server
|
|
||||||
[OPT2]:
|
|
||||||
all : Select all post with wip statuses
|
|
||||||
[FILE] : Select specific post (if wip status)
|
|
||||||
|
|
||||||
version | -v : Show local versionn
|
|
||||||
-vv : Shown local and repo Versions
|
|
||||||
```
|
|
||||||
|
|
@ -41,7 +41,7 @@ Attention: GSL aura besoin de créer des sous-dossier dans le serveur,
|
||||||
renseigné dans le questionnaire. (i.e. /var/www/). Il faut donc lui
|
renseigné dans le questionnaire. (i.e. /var/www/). Il faut donc lui
|
||||||
donner les droits
|
donner les droits
|
||||||
|
|
||||||
``
|
```
|
||||||
$ gsl new) domain
|
$ gsl new) domain
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue