gsl-statique-litterateur/help/how-to_Tips_Advises.md

1.3 KiB

Tips and Advises

Configuration

  • CSS acronym will always be in lower case

ABBR

  • short name (HEADER): must be in CAPS LOCK (abbr: LEC : Libre en communs)
  • short name (CONTENT): must contain a space (" LEC", " LEC ", "LEC ")

Files (Images, codes, scripts...)

You can create sub-directories in DOMAIN/files or DOMAIN/images If you do so, in your article HEADER, set FILENAME with sub-dirs, but do NOT begin with /

# File put in /var/lib/gsl/domains/DOMAIN/images/dir/dir1/pic.png
image: 1 : dir/dir1/pic.png

Images: set style and target

# Open in new tab pic, keep origin sizes
_image:1:+

# Open pic in new tab, using your css class and with width in pixel
# (height is kept)
_image:1:c:640px:+

Make (changes in your template)

If you change the content of a file in your template (script code, image, footer...), and you want ALL your articles to be updated, you will have to :

  • gsl sync
  • gsl make -F
  • gsl www add all

For only one article (myarticle).gsl:

  • gsl sync
  • gsl make -F (myarticle) (preview it first with wip server)
  • gsl www remove (myarticle)
  • gsl www add (myarticle)

Sidebar

If your remove a www or wip page, and you have put it in the sidebar, do not forget to replace it with another article. You can also have an automatic sidebar with

  • gsl sidebar latest