gsl-statique-litterateur/var/lib/gsl/new-version.md

## [0.1.0]

## Please, see help (and documentations in help folder)

### Add
- New code about everywhere, more comments, cleaner
- nano dependence
- Check installed configuration at launch
- Dedicated functions for ARGUMENTS in specific files category
- - check:             gsl__post_checkers
- - make,sidebar:      gsl__post_makers
- - sync,www,wip       gsl__srv_manager
- - log:               gsl__log_manager
- - db:                gsl__db_manager
- - author,new,setdir: gsl__domain_manager
- - edit:              gsl__edit_file
- - stats:             gsl__stats
- Basic RSS feed created at each www (COMMAND)
- - on root server: /DOMAIN/www/rss.xml
- Basic footer with new list (added RSS feed).
- - Do not forget to add link in your footer, to /rss.xml

### Installation
- new files:
- - gsl__srv_manager:     for all about server
- - gsl__version:         for -v, -vv, --version options
- - gsl__domain_manager:  for OPT author, new, setdir
- - gsl__edit_file:       functions to edit some configuration files
- - gsl__do_commons:      Common functions to filter article lines
- - gsl__HTML_template:   functions to create HTML pages
- New empty folder in installation:
- - /var/lib/gsl/db:      for all DBs (.gitkepp)
- - /var/lib/gsl/domains: for all domains (.gitkeep)
- - /var/log/gsl:         for logs files (.gitkeep)
- New help folder in
- - /var/lib/gsl/help     (removed "helps" one)
- - - Renamed documentation files (not all translated ; some in french)

### Logs
- Better logs harmony
- New fields in log for article filename and domain name
- Specific number of characters spaces in some log fields
- More verbose
- "automatic" level log set from called functions
- Colored levels: war (yellow), err (red)

### Databases
- Dedicated per article
- Folder: /var/lib/gsl/db/
- New file format: domains.db
- More datas with new stats. Quicker sourced datas
- Dedicated articles in sub-directory "DOMAIN"
- Check if corrupted DB
- Database and wip files won't be removed if errors in article
- If corrupted Database, try restoring www & wip statuses at new check

### Changes
- Changes in mapping process:
- - Processes get needed headers FIRST, then split article in 2 sections
- DOMAIN Profile is only in /var/lib/gsl/domains/DOMAIN/
- Variables in DOMAIN.conf file has no more "gsl_"
- Some translated words in HTML page from lang set DOMAIN (fr || en)
- Between markers (code): put "everything" you want
- New CSS classes: see gsl help css or documentation
- Mark image (i.e. "_image:1:mycss:50%:25%:+)"
- - define your own css class 'mycss'
- - define unity ("%","px"... with height and witdth)
- New lists. Mix "+" (ol) and "=" (ul) and write an item on several lines
- Between hX titles: new div css (none if empty content)
- Changing article Type will remove old wip file (not www file !)
- sync: Logs not shown but added
- stats properties file is now in /www (online)

### Process check [argument]
- slug: log err if already exists (log war if not well formated)

### new ARGUMENTS
- new (page|post) (name): Create article, show its content + check it
- new domain:   New domain configuration creator
- new author:   Same as author edit
- edit domains: Set/Edit registred domains database
- edit author:  Same as author edit
- author edit:  Opens nano to Add/Remove authors (one per line) by DOMAIN
- setdir:       Set current folder for your DOMAIN (show if one)
- check -N:     Only check newer articles not in DB
- clean all:    Remove all backups (only) files 
- sidebar:      add|replace|latest|oldest (See gsl help)
- www sync:     Same as sync www (see gsl help)
- wip ...:      Same as www but for wip (see gsl help)

### Markers
- css: MYCLASS  Customize each article with your CSS (optional)
- brut:         Insert brut code from file
- - In article header:  "NBR : FILENAME"``
- - In article content: "_brut: NBR"
- "_image:VALUE:MYCSS:WIDTH:HEIGHT:TARGET" (no target=no HTML link)
- Strong mark:   '•...•' (alt+gr + ;) on french azerty keyboard)
- Bold mark:     '·...·' (alt+gr + :) on french azerty keyboard)
- Emphasis mark: '”...”' (alt+gr + n) on french azerty keyboard)
- Strike mark:   '×...×' (alt+gr + shift + ;) on french azerty keyboard
- ```<<``` and ```>>``` as "start" and "close" marker for lists

### Template
- included basic header, metas and footer
- All about template is in /var/lib/gsl/scripts/gsl__HTML_template
- - No more header.html in templates folder
- - - Edit your own in create__HTML_header() function
- In /var/lib/gsl/domains/DOMAIN/templates/
- - Auto created metas.html and footer.html if not exist
- - Edit your own footer.html 
- - Edit your own metas per DOMAIN for HTML ```<head>``` in metas.html
- - - included basic pre-registred meta from datas article
- - No CSS styles included: create your own (see classes and IDs used in doc)
- For all changes here, after gsl make, use gsl sync...

### Sidebar
- No more /var/lib/gsl/domains/DOMAIN/templates/last-posts-list.html
- - Remove it with files xxx.X in /var/lib/gsl/domains/DOMAIN/X-tra/
- New HTML file: /var/lib/gsl/domains/DOMAIN/templates/sidebar.html
- - Created with files /var/lib/gsl/domains/DOMAIN/X-tra/sidebar/(POS).html
- articles are sorted from epoch date (in DB) with false time at check

### Statoolinfos (added properties for www status)
- Genereated at each www (add/remove)
- gsl.articles
- gsl.articles.pages
- gsl.articles.posts
- gsl.authors
- gsl.articles.tags
- gsl.articles.words
- gsl.articles.quotes
- gsl.articles.paragraphs
- gsl.articles.links
- gsl.articles.links.online
- gsl.articles.lists
- gsl.articles.lists.items
- gsl_articles.images

### CRITIK
- Remove all files in /var/lib/gsl/db/
- Use: ```gsl new domain```, give your registred DOMAIN name
- - Answer Y to autofix old configurations files and folders
- - Do it for each DOMAIN you registred
- - will add site_max_list=5 (default) in domain configuration file
- Use ```gsl check``` in your articles folder