Lepagito - Goodies

Groups of tags

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

In many cases, the tag list becomes very long and contains heterogeneous tags. It should be better to group them: this feature is implemented in the Lepagito theme. For instance, in the pelicanconf.py file:

TAGS_BY_GROUPS = (
  ('Color',  ('blue', 'red', 'yellow')),
  ('State',  ('solid', 'liquid', 'gas')),
  ('Firtname', ('Isabelle', 'Pierre', 'Paul', 'Jacques')),)

If a tag appears in an article but has any defined group, it will appear in the 'Others' group.

Archives and calendar

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

The Archives, available at the footer menu, starts with a calendar, that provides a concise view. Years and months are both links to periodic archives. In the pelicanconf.py file, the two following variables should be defined, for instance as:

YEAR_ARCHIVE_SAVE_AS  = 'archive_{date:%Y}.html'
MONTH_ARCHIVE_SAVE_AS = 'archive_{date:%Y}_{date:%m}.html'

The calendar view do not refer to any pelican plugin: this is an original functionality of the Lepagito theme. If you don't want the calendar to appear on the archives page, you could either not define at least one of these variable, or set:

ARCHIVES_CALENDAR = False

By default, this variable is True.

Footer menus

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

This theme provides an optional horizontal menu located at the bottom if each page: the footer menu. It could be useful for contact and license entries:

FOOTERMENUITEMS = (
  ('About',    'about.html'),
  ('Contact',  'contact.html'),
  ('Links',    'links.html'),
  ('License',  'license.html'),
)

A second bottom horizontal menu presents the Archives and feeds. This menu is active by default and could be removed with:

FOOTERMENUFEED = False

Finally, a third bottom horizontal menu could optionally defined by the SOCIAL standard variable of the pelican environment. This variable is not used in the pelicanconf.py file of the present documentation. As for the MENUITEMS and FOOTERMENUITEMS variables, it consists of a list of tuples (title, url). Note that this menu points to pages such as about.html, and there is a corresponding about.rst source file that looks like:

About
------
:date: 2023-02-14
:status: hidden

Yes, we have writen this amazing blog!

Observe that such a file is not a blog article: it has the status hidden and do not appear in the navigation of articles.

Internationalization (I18N)

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

All labels introduced by the present theme are modifiable. The present pelicanconf.py provides its complete list together with the default English values:

I18N_CATEGORY  = 'Category'
I18N_TAGS      = '#Tags'
I18N_TOP       = 'Top'
I18N_PAGE      = 'Page'
I18N_READ_MORE = 'Read more'
I18N_ARCHIVES  = 'Archives'
I18N_FEED_ALL_ATOM = 'Feed'
I18N_NEWEST    = 'Newest'
I18N_OLDEST    = 'Oldest'
I18N_FIRST     = 'First'
I18N_LAST      = 'Last'
I18N_BACK_TO   = 'Back to'
I18N_OTHERS    = 'Others'