84 lines
No EOL
2.8 KiB
Markdown
84 lines
No EOL
2.8 KiB
Markdown
siglican
|
|
========
|
|
|
|
A static gallery generator plugin for Pelican, based on the Sigal
|
|
Colorbox/Galleria static site generator.
|
|
|
|
##How To
|
|
1. Put this folder into your Pelican plugins directory. Add 'siglican' to
|
|
PLUGINS in pelicanconf.py.
|
|
2. Create a 'siglican' directory in your base directory, at the same level as
|
|
'content'. Drag 'colorbox' or 'galleria' from the 'themes' directory into
|
|
this folder. Also create an 'images' subdirectory under 'siglican'.
|
|
3. Create album and image metadata, as desired.
|
|
4. Create theme directory inside of 'siglican'. Use the colorbox or galleria
|
|
theme as a starting point. Make sure that your Pelican theme's base.html
|
|
template has a 'head' block defined before </head>.
|
|
|
|
###Example directory tree:
|
|
```
|
|
/site
|
|
/content/*
|
|
/plugins/siglican/*.py
|
|
/siglican
|
|
/images
|
|
/album1
|
|
/album2
|
|
/...
|
|
/[colorbox|galleria]
|
|
/static/*
|
|
/templates/album.html
|
|
```
|
|
|
|
###Pelican Configuration Settings
|
|
|
|
These are the default values of the settings that can be configured in
|
|
pelicanconf.py:
|
|
|
|
* SIGLICAN_ALBUMS_SORT_REVERSE: False
|
|
* SIGLICAN_AUTOROTATE_IMAGES: True
|
|
* SIGLICAN_COLORBOX_COLUMN_SIZE: 4
|
|
* SIGLICAN_COPY_EXIF_DATA: False
|
|
* SIGLICAN_DESTINATION: 'gallery'
|
|
* SIGLICAN_FILES_TO_COPY: ()
|
|
* SIGLICAN_IGNORE_DIRECTORIES: ['.']
|
|
* SIGLICAN_IGNORE_FILES: []
|
|
* SIGLICAN_IMG_PROCESSOR: 'ResizeToFit'
|
|
* SIGLICAN_IMG_SIZE: (640, 480)
|
|
* SIGLICAN_INDEX_IN_URL: False
|
|
* SIGLICAN_JPG_OPTIONS: {'quality': 85, 'optimize': True, 'progressive': True}
|
|
* SIGLICAN_LINKS: ''
|
|
* SIGLICAN_LOCALE: ''
|
|
* SIGLICAN_MEDIAS_SORT_ATTR: 'filename'
|
|
* SIGLICAN_MEDIAS_SORT_REVERSE: False
|
|
* SIGLICAN_MAKE_THUMBS: True
|
|
* SIGLICAN_ORIG_DIR: 'original'
|
|
* SIGLICAN_ORIG_LINK: False
|
|
* SIGLICAN_SOURCE: 'siglican'
|
|
* SIGLICAN_THEME: 'colorbox'
|
|
* SIGLICAN_THUMB_DIR: 'thumbs'
|
|
* SIGLICAN_THUMB_FIT: True
|
|
* SIGLICAN_THUMB_PREFIX: ''
|
|
* SIGLICAN_THUMB_SIZE: (200, 150)
|
|
* SIGLICAN_THUMB_SUFFIX: ''
|
|
* SIGLICAN_VIDEO_SIZE: (480, 360)
|
|
* SIGLICAN_WEBM_OPTIONS: ['-crf', '10', '-b:v', '1.6M','-qmin', '4', '-qmax', '63']
|
|
* SIGLICAN_WRITE_HTML: True
|
|
* SIGLICAN_ZIP_GALLERY: False
|
|
* SIGLICAN_ZIP_MEDIA_FORMAT: 'resized'
|
|
|
|
## Future
|
|
1. Unit tests.
|
|
2. Update colorbox/galleria example themes to deal better with nested albums.
|
|
3. Streamline/refactor/merge modules.
|
|
|
|
## Notes
|
|
For more on creating Pelican generator plugins, see the [Pelican plugin documentation]
|
|
(http://docs.getpelican.com/en/latest/plugins.html#how-to-create-plugins) and
|
|
[Pelican internals](http://docs.getpelican.com/en/latest/internals.html).
|
|
|
|
##Credits
|
|
* Around 2/3 of the core Python code is ported from
|
|
[Sigal v0.8.0](http://sigal.saimon.org/) by Simon Conseil.
|
|
* Heavily leverages Pelican, Jinja2, Colorbox, and Galleria.
|
|
* Pelican generator plugin implementation and integration by Scott Boone (sawall@github). |