Add a setting and a cli option to specify the gallery title (ref #91).

docs/changelog.rst

@@ -7,6 +7,8 @@ Version 0.8.dev
 
 Released on 2014-xx-xx.
 
+- Add a setting and a cli option to specify the gallery title (``title`` and
+  ``--title``) (ref #91).
 - Add a mailing list at Librelist (sigal at librelist.com).
 - Add an option to specify the port to use for the serve command.
 - Replace argh with click.

sigal/__init__.py

@@ -85,8 +85,10 @@ def init(path):
         help="Configuration file")
 @option('-t', '--theme', help="Specify a theme directory, or a theme name for "
         "the themes included with Sigal")
+@option('--title', help="Title of the gallery (overrides the title setting.")
 @option('-n', '--ncpu', help="Number of cpu to use (default: all)")
-def build(source, destination, debug, verbose, force, config, theme, ncpu):
+def build(source, destination, debug, verbose, force, config, theme, title,
+          ncpu):
     """Run sigal to process a directory.
 
     If provided, 'source', 'destination' and 'theme' will override the
@@ -121,6 +123,9 @@ def build(source, destination, debug, verbose, force, config, theme, ncpu):
                      "directory.")
         sys.exit(1)
 
+    if title:
+        settings['title'] = title
+
     locale.setlocale(locale.LC_ALL, settings['locale'])
     init_plugins(settings)
 

sigal/gallery.py

@@ -470,6 +470,11 @@ def __init__(self, settings, ncpu=None):
         self.logger.debug('Albums:\n%r', albums.values())
         signals.gallery_initialized.send(self)
 
+    @property
+    def title(self):
+        """Title of the gallery."""
+        return self.settings['title'] or self.albums['.'].title
+
     def init_pool(self, ncpu):
         try:
             cpu_count = multiprocessing.cpu_count()
@@ -539,8 +544,7 @@ def build(self, force=False):
             print('')
 
         if self.settings['write_html']:
-            writer = Writer(self.settings, index_title=self.albums['.'].title)
-
+            writer = Writer(self.settings, index_title=self.title)
             for album in self.albums.values():
                 writer.write(album)
 

sigal/settings.py

@@ -61,6 +61,7 @@
     'thumb_prefix': '',
     'thumb_size': (200, 150),
     'thumb_suffix': '',
+    'title': '',
     'video_size': (480, 360),
     'webm_options': ['-crf', '10', '-b:v', '1.6M',
                      '-qmin', '4', '-qmax', '63'],

sigal/templates/sigal.conf.py

@@ -4,6 +4,11 @@
 # to show the default. Default values are specified when modified in this
 # example config file
 
+# Gallery title. Can be set here or as the '--title' option of the `sigal
+# build` command, or in the 'index.md' file of the source directory.
+# The priority order is: cli option > settings file > index.md file
+# title = "Sigal test gallery"
+
 # Source directory. Can be set here or as the first argument of the `sigal
 # build` command
 source = 'pictures'