[pull] master from getpelican:master

.github/workflows/build-preview-site.yml

@@ -0,0 +1,76 @@
+name: Build pelican-themes preview site
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow one concurrent deployment
+concurrency:
+  group: "pages"
+  cancel-in-progress: true
+
+on:
+  # Triggers the workflow on push or pull request events but only for the "main" branch
+  push:
+    branches: [ "master" ]
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+
+    steps:
+      - name: Checkout repo
+        uses: actions/checkout@v3
+        with:
+          fetch-depth: 1
+          submodules: recursive
+      - name: Checkout pelican
+        uses: actions/checkout@v3
+        with:
+          repository: getpelican/pelican
+          path: _pelican
+          fetch-depth: 1
+      - name: Setup python-3.10
+        uses: actions/setup-python@v4
+        with:
+          python-version: "3.10"
+      - name: Cache Playwright browsers
+        uses: actions/cache@v3
+        with:
+          path: ~/.cache/ms-playwright/
+          key: ${{ runner.os }}-browsers
+      - name: Install pelican, plugins and shot-scraper
+        run: pip install pelican[markdown] pelican-webassets cssmin shot-scraper
+      - name: Setup shot-scraper
+        run: shot-scraper install
+      - name: Generate output
+        run: python build-theme-previews.py
+
+      # Rsync to server hosting pelicanthemes.com
+      - name: Install SSH key
+        uses: shimataro/ssh-key-action@v2
+        with:
+          key: ${{ secrets.SSH_PRIVATE_KEY }}
+          known_hosts: unnecessary
+      - name: Adding known hosts
+        run: ssh-keyscan -p 22 -H pelicanthemes.com  >> ~/.ssh/known_hosts
+      - name: Deploy with rsync
+        run: rsync -avz ./_output/ [email protected]:~/roles/caddy/sites/pelicanthemes.com/
+
+      # Deploy to Github Pages
+      - name: Setup Pages
+        uses: actions/configure-pages@v2
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v1
+        with:
+          path: '_output'
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v1

.gitignore

@@ -15,3 +15,8 @@ Thumbs.db
 *~
 .swp
 .*.swp
+
+# Preview artifacts #
+#####################
+_pelican
+_output

.gitmodules

@@ -143,9 +143,6 @@
 [submodule "alchemy"]
 	path = alchemy
 	url = https://github.com/nairobilug/pelican-alchemy.git
-[submodule "Nuja"]
-	path = Nuja
-	url = https://github.com/allenskd/Nuja.git
 [submodule "pjport"]
 	path = pjport
 	url = https://github.com/xm3ron/pjport.git
@@ -155,9 +152,6 @@
 [submodule "Flex"]
 	path = Flex
 	url = https://github.com/alexandrevicenzi/Flex.git
-[submodule "Casper2Pelican"]
-	path = Casper2Pelican
-	url = https://github.com/abr4xas/Casper2Pelican.git
 [submodule "octopress"]
 	path = octopress
 	url = https://github.com/MrSenko/pelican-octopress-theme
@@ -224,6 +218,9 @@
 [submodule "jojo"]
 	path = jojo
 	url = https://github.com/dokelung/jojo.git
+[submodule "supersimple"]
+	path = supersimple
+	url = https://github.com/hlrossato/supersimple.git
 [submodule "resume"]
 	path = resume
 	url = https://github.com/suheb/resume.git
@@ -261,3 +258,9 @@
 [submodule "blue-penguin-dark"]
 	path = blue-penguin-dark
 	url = https://github.com/tcarwash/blue-penguin-dark.git
+[submodule "pelican-haerwu-theme"]
+	path = pelican-haerwu-theme
+	url = https://github.com/hrw/pelican-haerwu-theme.git
+[submodule "Piccolo"]
+	path = piccolo
+	url = https://github.com/iamjameswalters/piccolo.git

README.rst

@@ -51,3 +51,19 @@ that any edits you make are made to the copy stored in
 ``~/pelican-themes/theme-name``. Any changes made to
 files stored in your site's ``output`` directory will be deleted the next
 time you generate your site.
+
+Generating Theme Previews
+#########################
+
+Generating theme previews happens automatically via a GitHub Actions workflow,
+after which those previews are published to https://pelicanthemes.com.
+If you want to generate previews locally on your workstation, clone the Pelican
+repository (for example, to `~/projects/pelican/`), clone this repository
+somewhere, change to the root directory of that clone, and follow these steps:
+
+.. code-block:: sh
+
+	python -m pip install pelican[markdown] shot-scraper
+        mkdir _pelican
+        cp -r ~/projects/pelican/samples _pelican/
+        python build-theme-previews.py