Migrating My Blog from WordPress to GitHub Pages: Lessons Learned

GitHub Pages is a new tool that lets you build and deploy sites using GitHub Actions. The GitHub Marketplace offers Actions to help you with it. The alternative is to deploy *yourself* using a custom GitHub workflow. GitHub Pages builds for Jekyll, but you can put a ‘nojekyll’ file at the root of the Pages branch to prevent it.


This content originally appeared on HackerNoon and was authored by Nicolas Frankel

I moved my blog from WordPress to GitLab Pages in… 2016. I'm happy with the solution. However, I used GitHub Pages when I was teaching for both the courses and the exercises, e.g., Java EE. At the time, there were no GitHub Actions: I used Travis CI to build and deploy.

\ Recently, I had to use GitHub Pages to publish my Apache APISIX workshop. Travis is no longer free. GitHub Actions are a thing. I used the now nominal path and faced a few hurdles; here are my findings.

GitHub Pages, at the time

The previous usage of GitHub Pages was pretty straightforward. You pushed to a specific branch, gh-pages. GitHub Pages rendered the root of the branch as a website.

\ Travis works by watching a .travis.yml build file at the repository root. When it detects a change, it runs it. I designed the script to build HTML from Asciidoc sources and push it to the branch. Here's the significant bit:

\

after_success:
 # - ...
   - git push --force --quiet "https://${GH_TOKEN}@${GH_REF}" master:gh-pages > /dev/null 2>&1

GitHub Pages now

When you enable GitHub Pages, you can choose its source: GitHub Actions or Deploy from a branch. I used a workflow to generate HTML from Asciidoctor, and my mistake was selecting the first choice.

GitHub Pages from a branch

If you choose Deploy from a branch, you can select the branch name and the source root folder. Apart from that, the behavior is similar to the pre-GitHub Action behavior. A vast difference, however, is that GitHub runs a GitHub Action after each push to the branch, whether the push happens via an Action or not.

While you can see the workflow executions, you cannot access its YAML source. By default, the build job in the workflow runs the following phases:

\

  • Set up job
  • Pull the Jekyll build page Action
  • Checkout
  • Build with Jekyll
  • Upload artifact
  • Post Checkout
  • Complete job

\ Indeed, whether you want it or not, GitHub Pages builds for Jekyll! I don't want it because I generate HTML from Asciidoc. To prevent Jekyll build, you can put a .nojekyll file at the root of the Pages branch. With it, the phases are:

\

  • Set up job
  • Checkout
  • Upload artifact
  • Post Checkout
  • Complete job

\ No more Jekyll!

GitHub Pages from Actions

The pages-build-deployment Action above creates a tar.gz archive and upload it to the Pages site. The alternative is to deploy yourself using a custom GitHub workflow. The GitHub Marketplace offers Actions to help you with it:

\

\ The documentation does an excellent job of explaining how to use them across your custom workflow.

Conclusion

Deploying to GitHub Pages offers two options: either from a branch or from a custom workflow. In the first case, you only have to push to the configured branch; GitHub will handle the internal mechanics to make it work via a provided workflow. You don't need to pay attention to the logs. The alternative is to create your custom workflow and assemble the provided GitHub Actions.

\ Once I understood the options, I made the first one work. It's good enough for me, and I don't need to care about GitHub Pages' internal workings.

\ To go further:

\

\


This content originally appeared on HackerNoon and was authored by Nicolas Frankel


Print Share Comment Cite Upload Translate Updates
APA

Nicolas Frankel | Sciencx (2024-06-20T20:17:29+00:00) Migrating My Blog from WordPress to GitHub Pages: Lessons Learned. Retrieved from https://www.scien.cx/2024/06/20/migrating-my-blog-from-wordpress-to-github-pages-lessons-learned/

MLA
" » Migrating My Blog from WordPress to GitHub Pages: Lessons Learned." Nicolas Frankel | Sciencx - Thursday June 20, 2024, https://www.scien.cx/2024/06/20/migrating-my-blog-from-wordpress-to-github-pages-lessons-learned/
HARVARD
Nicolas Frankel | Sciencx Thursday June 20, 2024 » Migrating My Blog from WordPress to GitHub Pages: Lessons Learned., viewed ,<https://www.scien.cx/2024/06/20/migrating-my-blog-from-wordpress-to-github-pages-lessons-learned/>
VANCOUVER
Nicolas Frankel | Sciencx - » Migrating My Blog from WordPress to GitHub Pages: Lessons Learned. [Internet]. [Accessed ]. Available from: https://www.scien.cx/2024/06/20/migrating-my-blog-from-wordpress-to-github-pages-lessons-learned/
CHICAGO
" » Migrating My Blog from WordPress to GitHub Pages: Lessons Learned." Nicolas Frankel | Sciencx - Accessed . https://www.scien.cx/2024/06/20/migrating-my-blog-from-wordpress-to-github-pages-lessons-learned/
IEEE
" » Migrating My Blog from WordPress to GitHub Pages: Lessons Learned." Nicolas Frankel | Sciencx [Online]. Available: https://www.scien.cx/2024/06/20/migrating-my-blog-from-wordpress-to-github-pages-lessons-learned/. [Accessed: ]
rf:citation
» Migrating My Blog from WordPress to GitHub Pages: Lessons Learned | Nicolas Frankel | Sciencx | https://www.scien.cx/2024/06/20/migrating-my-blog-from-wordpress-to-github-pages-lessons-learned/ |

Please log in to upload a file.




There are no updates yet.
Click the Upload button above to add an update.

You must be logged in to translate posts. Please log in or register.