diff --git a/docs/content.rst b/docs/content.rst index a6d1c4c6..f0022c35 100644 --- a/docs/content.rst +++ b/docs/content.rst @@ -116,7 +116,7 @@ specified either via the ``tags`` metadata, as is standard in Pelican, or via the ``keywords`` metadata, as is standard in HTML. The two can be used interchangeably. -Note that, aside from the title, none of this article metadata is mandatory: +Note that, aside from the title, none of this content metadata is mandatory: if the date is not specified and ``DEFAULT_DATE`` is set to ``'fs'``, Pelican will rely on the file's "mtime" timestamp, and the category can be determined by the directory in which the file resides. For example, a file located at @@ -126,6 +126,15 @@ not be a good category name, you can set the setting ``USE_FOLDER_AS_CATEGORY`` to ``False``. When parsing dates given in the page metadata, Pelican supports the W3C's `suggested subset ISO 8601`__. +So the title is the only required metadata. If that bothers you, worry not. +Instead of manually specifying a title in your metadata each time, you can use +the source content file name as the title. For example, a Markdown source file +named ``Publishing via Pelican.md`` would automatically be assigned a title of +*Publishing via Pelican*. If you would prefer this behavior, add the following +line to your settings file:: + + FILENAME_METADATA = '(?P