Lepagito - Options

Article navigation

2021-05-14T00:00:00+02:00

The navigation between two successive pagination of article summaries is presented at the bottom: it provides both Oldest/Newest pages and also Fist/Last, for efficiency. When reading articles, the navigation between previous and next articles is presented both at the top and the bottom. This navigation feature is implemented thanks to the pelican neighbors plugin.

By default, the oldest pages and article navigation links appear on the right, and newest on the left. The LEPAGITO_NAVIGATION_SWAP variable in the pelicanconf.py file allows to swap from left to write this navigation. This feature is useful when the chronology of a blog is not important, as in the present documentation of the lepagito theme: the newest article means only the first article to read.

Self-hosted search

2021-04-14T00:00:00+02:00

The search function appears at the right of the top menu bar. Rather than give up control and privacy to third-party search engine corporations, this function adds elegant and self-hosted search capability to your site. Last but not least, searches are really fast. The search function is implemented thanks to the pelican search plugin. The search engine is activated by the following line in the pelicanconf.py file:

SEARCH_MODE = 'output'

Note that the search function requires that the blog is installed: it do not work in the off-line mode. If you do not need searches on your site, e.g. your tags are sufficients, just remove the previous line from the pelicanconf.py and the search function will disappear from the top menu bar.

If you are in trouble when installing stork, that is necessary for running the pelican search plugin, you could just remove both this plugin and previous line from the pelicanconf.py:

PLUGINS = ['neighbors']
#SEARCH_MODE = 'output'

Sitemap

2021-03-14T00:00:00+01:00

The sitemap plugin generates a sitemap.xml file to facilitate the indexing of your site by search engines. There is nothing to configure, it works as a black-box.

Photo galleries

2021-02-14T00:00:00+01:00

Last but not the least, the galleria plugin allows to easily manage galleries of images. Especially, it nicely manages the automatic generation of thumbnails from images, as shown in the following gallery of watercolors due to Pirogh:

When you click on a thumbnail of a picture, a full resolution version of this picture is displayed. Also, try to resize the browser window and observe the responsive display of the gallery: the gallery is automatically readjusted and this is especially useful when displaying on mobile phones. Finally the thumbnail's image resolution itself is also responsive, in the sense that it takes into account the physical resolution of our window and screen resolution. See the source file of this documentation for a complete example and also the documentation of the galleria plugin for more.

To associate an image with an article, i.e. as an icon, add the metadata field. For restructured text .rst files, it writes:

:image: myimage.jpg

to the header of an article. Associated images improve navigation: icons are displayed together with article titles when browsing pages and Archives.

Custom colors

2021-01-14T00:00:00+01:00

All colors of the lepagito theme are customizable. The default color file is color.css and an alternate file could be specicied by using the LEPAGITO_COLOR_CSS_FILE variable in the pelicanconf.py, such as:

LEPAGITO_COLOR_CSS_FILE  = 'mycustomcolor.css'

Modifying by hand the color.css file is not obvious: for convenience, a python script mk_custom_color_css.py is provided in the static/css directory. It admits three arguments: the two first are the rotation angles for the hue of the warm and cold colors, and the third argument is the optional basename for the css output file. For zero rotation, enter the command:

python mk_custom_color_css.py 0 0 mycustomcolor

It will regenerate exactly the default color theme but in the file mycustomcolor.css. It also provides mycustomcolor.pig, which is the color set, suitable for the palette visualization software. This default color theme corresponds to a palette composed to two groups of colors, the warm magenta and cold blue groups:

The second image represent the color palette in the CIECAM Jab coordinate system, in the (a,b) plane: observe the two groups of colors. The present graph is obtained thanks to the palette visualization software.

Now, let us rotate the cold blue group, until reaching the yellow position on the palette:

python mk_custom_color_css.py 0 195 mycustomcolor
cd ../../doc
pelican content
firefox output/index.html &

We then obtain:

Let us now rotate the same group until it reaches the magenta position:

python mk_custom_color_css.py 0 120 mycustomcolor

The two groups are now superposed and we obtain a camaïeu:

Finally, the first warm group is also rotated until it reaches the blue position:

python mk_custom_color_css.py 240 120 mycustomcolor

The two initial groups are now swapped: