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

5.5 KiB
Raw Blame History

[0.0.92]

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

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)

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
  • 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
  • wip ...: Same as www but for wip

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