Conversion of pelicanconf.py to pelicanconf.yaml.
See github.com/apache/template-site and inspect a full pelicanconf.yaml
These are the sections:
site: name: Apache Template description: Provides a template for projects wishing to use the Pelican ASF static content system domain: template.apache.org logo: images/logo.png repository: https://github.com/apache/template-site/blob/main/content/ trademarks: Apache, the Apache feather logo, and "Project" are trademarks or registered trademarks theme: theme/apache
If you are using the standard plugins included in Pelican ASF then you can leave this section out. Your build will automatically include the
plugins: paths: - theme/plugins use: - gfm
These configure four different special features.
setup: data: asfdata.yaml run: - /bin/bash shell.sh ignore: - README.md - include - docs copy: - docs
asfdataplugin to build a data model to use in
ezmdfiles. www-site is the best example.
asfshellplugin to run scripts. httpd-site's security vulnerability processing is the best example.
asfcopyplugin to copy static files outside of the pelican process. Include these in ignore as well. This is useful if you have large files or many static files.
asfgenid plugin performs a number of fixups and enhancements. See ASF_GENID in your
pelicanconf.py and convert.
genid: unsafe: yes metadata: yes elements: yes headings_depth: 4 permalinks: yes toc_depth: 4 tables: yes