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

47 lines
1.3 KiB
Markdown

# 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