More flexible pelican config/run.

The current buildsite.py process assumes the content is placed into
"content". This is fixed through a new CONTENT_DIR variable.

generate_settings() makes some assumptions about the location of the
theme and any plugins. Clarify this with SETTINGS_DIR variable.

For now, just hack in a look for a "site" directory, which we knows
contains all of the above. If a "content" directory is present, then
it is the original layout, and we keep on rollin'

Added some docco at the head to specify what is needed to run this
script in a local dev/test scenario.
1 file changed
tree: 99c6e860ea63915c5102e5e4a152cb8a7cbdffcd
  1. bin/
  2. devtest/
  3. plugins/
  4. .dockerignore
  5. .gitignore
  6. DOCKER.md
  7. Dockerfile
  8. LICENSE
  9. pelicanconf.md
  10. README.md
  11. requirements.txt
README.md

Tools for using Pelican at the ASF

TBD

Step One: Build libcmark-gfm

$ mkdir /tmp/cm
$ cd /tmp/cm
$ /path/to/infrastructure-pelican/bin/build-cmark.sh
... (build output here)
export LIBCMARKDIR='/tmp/cm/cmark-gfm-0.28.3.gfm.12/lib'
$

Copy/paste/execute that printed export line for use in the following steps.

(of course, you may use any location of your choice; /tmp/cm is merely an example)

Installing libcmark-gfm via packages

TBD: install a .deb from packages.apache.org

TBD: maybe a macOS variant?

TBD: maybe Windows?

Step Two

TBD: credentials need to provided in (eg.) bb2.txt

$ ./kick_build.py --repo=www-site --notify=somewhere@example.com --theme theme/apache --min-pages=200