feat!: Add blog back to main repository (#2704)

Signed-off-by: kimg45 <[email protected]>
Signed-off-by: blacklight447 <[email protected]>
Signed-off-by: redoomed1 <[email protected]>

.github/workflows/build-blog.yml

@@ -0,0 +1,88 @@
+name: 🛠️ Build Blog
+
+on:
+  workflow_call:
+    inputs:
+      ref:
+        required: true
+        type: string
+      repo:
+        required: true
+        type: string
+      context:
+        type: string
+        default: deploy-preview
+      continue-on-error:
+        type: boolean
+        default: true
+      privileged:
+        type: boolean
+        default: true
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    continue-on-error: ${{ inputs.continue-on-error }}
+    permissions:
+      contents: read
+
+    steps:
+      - name: Add GitHub Token to Environment
+        run: |
+          echo "GH_TOKEN=${{ secrets.GITHUB_TOKEN }}" >> "$GITHUB_ENV"
+
+      - name: Download Repository
+        uses: actions/checkout@v4
+        with:
+          repository: ${{ inputs.repo }}
+          ref: ${{ inputs.ref }}
+          persist-credentials: "false"
+          fetch-depth: 0
+
+      - name: Download Submodules
+        uses: actions/download-artifact@v4
+        with:
+          pattern: repo-*
+          path: modules
+
+      - name: Move mkdocs-material-insiders to mkdocs-material
+        if: inputs.privileged
+        run: |
+          rmdir modules/mkdocs-material
+          mv modules/repo-mkdocs-material-insiders modules/mkdocs-material
+
+      - name: Move brand submodule to theme/assets/brand
+        run: |
+          rmdir theme/assets/brand
+          mv modules/repo-brand theme/assets/brand
+
+      - name: Install Python (pipenv)
+        if: inputs.privileged
+        uses: actions/setup-python@v5
+        with:
+          cache: "pipenv"
+
+      - name: Install Python Dependencies
+        if: inputs.privileged
+        run: |
+          pip install pipenv
+          pipenv install
+          sudo apt install pngquant
+
+      - name: Build Website
+        run: |
+          pipenv run mkdocs build --config-file mkdocs.blog.yml
+
+      - name: Package Website
+        run: |
+          tar -czf site-build-blog.tar.gz site
+
+      - name: Upload Site
+        uses: actions/upload-artifact@v4
+        with:
+          name: site-build-blog.tar.gz
+          path: site-build-blog.tar.gz
+          retention-days: 1

.github/workflows/build-pr.yml

@@ -87,12 +87,23 @@ jobs:
       privileged: ${{ fromJSON(needs.metadata.outputs.privileged) }}
       strict: true
 
+  build_blog:
+    if: ${{ contains(github.event.pull_request.labels.*.name, 'ci:build blog') }}
+    needs: [submodule, metadata]
+    uses: ./.github/workflows/build-blog.yml
+    with:
+      ref: ${{github.event.pull_request.head.ref}}
+      repo: ${{github.event.pull_request.head.repo.full_name}}
+      continue-on-error: true
+      privileged: ${{ fromJSON(needs.metadata.outputs.privileged) }}
+
   combine_build:
-    needs: [build_english, build_i18n]
+    needs: [build_english, build_i18n, build_blog]
     if: |
       (always() && !cancelled() && !failure()) &&
       needs.build_english.result == 'success' &&
-      (needs.build_i18n.result == 'success' || needs.build_i18n.result == 'skipped')
+      (needs.build_i18n.result == 'success' || needs.build_i18n.result == 'skipped') &&
+      (needs.build_blog.result == 'success' || needs.build_blog.result == 'skipped')
 
     runs-on: ubuntu-latest
     steps:
@@ -114,5 +125,5 @@ jobs:
 
   cleanup:
     if: ${{ always() }}
-    needs: [build_english, build_i18n]
+    needs: [build_english, build_i18n, build_blog]
     uses: privacyguides/.github/.github/workflows/cleanup.yml@main

Pipfile

@@ -29,6 +29,7 @@ mkdocs-git-revision-date-localized-plugin = "~=1.2"
 mkdocs-git-authors-plugin = "~=0.8"
 mkdocs-macros-plugin = "~=1.0"
 jieba = "~=0.42"
+mkdocs-rss-plugin = "*"
 
 [dev-packages]
 scour = "~=0.38"

blog/.authors.yml

@@ -0,0 +1,51 @@
+authors:
+  contributors:
+    type: Organization
+    name: Privacy Guides
+    description: Various Authors
+    avatar: https://github.com/privacyguides.png
+  danarel:
+    name: Dan Arel
+    description: Former Team Member
+    avatar: https://github.com/danarel.png
+  niek-de-wilde:
+    name: Niek de Wilde
+    description: Team Member
+    avatar: https://github.com/blacklight447.png
+  dngray:
+    name: Daniel Gray
+    description: Team Member
+    avatar: https://github.com/dngray.png
+  freddy-m:
+    name: Freddy
+    description: Team Member
+    avatar: https://github.com/freddy-m.png
+    description_long: |
+      <a href="https://freddy.lol">Freddy</a> is a founding member of Privacy Guides and the editor of its blog. He writes in American English reluctantly.
+  jonah:
+    name: Jonah Aragon
+    description: Team Member
+    avatar: https://github.com/jonaharagon.png
+    description_long: |
+      <a href="https://www.jonaharagon.com">Jonah Aragon</a> is creating educational resources for average people to understand the importance of privacy and security on the internet, and take back control over their digital lives.
+      He is known for his work on the Techlore YouTube channel, including the Techlore Talks podcast he co-hosts, and the Privacy Guides non-profit website.
+  kaitebay:
+    name: Kai Tebay
+    description: Former Team Member
+    avatar: https://github.com/kaitebay.png
+  matchboxbananasynergy:
+    name: mbananasynergy
+    description: Former Team Member
+    avatar: https://github.com/matchboxbananasynergy.png
+  mfwmyfacewhen:
+    name: mfwmyfacewhen
+    description: Former Team Member
+    avatar: https://github.com/ghost.png
+  natebartram:
+    name: Nate Bartram
+    description: Guest Contributor
+    avatar: https://gitlab.com/uploads/-/system/user/avatar/8993331/avatar.png
+  sam-howell:
+    name: Sam Howell
+    description: Guest Contributor
+    avatar: https://gitlab.com/uploads/-/system/user/avatar/5349522/avatar.png

blog/archive/2019.md

@@ -0,0 +1,3 @@
+!!! danger "Old Content"
+
+    These posts are 5 years old. They may not accurately reflect the current opinion of our team.

blog/archive/2020.md

@@ -0,0 +1,3 @@
+!!! danger "Old Content"
+
+    These posts are 4 years old. They may not accurately reflect the current opinion of our team.

blog/archive/2021.md

@@ -0,0 +1,3 @@
+!!! danger "Old Content"
+
+    These posts are 3 years old. They may not accurately reflect the current opinion of our team.

blog/archive/2022.md

@@ -0,0 +1,3 @@
+!!! danger "Old Content"
+
+    These posts are 2 years old. They may not accurately reflect the current opinion of our team.

blog/index.md

@@ -0,0 +1,5 @@
+---
+title: Latest Articles
+hide:
+  - footer
+---

blog/posts/.meta.yml

@@ -0,0 +1 @@
+comments: true