Move from VuePress to Jekyll (Change DNS config)
We have been having issues with VuePress, mainly:
- Hard to edit the frontpage
- It is split into
index.md
and.vuepress/theme/Home.vue
- Could not reorganize sections on the frontpage (because it's split in 2)
- Could not add images on the
Home.vue
file (errors)
- It is split into
- Images are in 2 folders - why? Which ones are we using?
- .vuepress/public
- /img/
- Big learning curve. Hard for newcomers to understand
- Site broke (navigation links stopped working) after a simple type-o was made in a JavaScript section.
This is the commit that broke the site navigation:
We could probably fix all those issues, but it might be better to stick with a tech stack we already know.
Viktor started working on updating VuePress to a newer version in !4 (merged) but had issues with that one also. Then decided it was easier to move it to Jekyll instead.
Pros using Jekyll
- Goal: We want multiple people to contribute. Not just developers
- Keep it simple so you only need Markdown knowledge or HTML/CSS - Not JavaScript or understand complex folder structures.
- We already know Jekyll and it's used on multiple pages:
- None-developers feel comfortable using it
Maybe there is a newer VuePress version which is simpler for non-developers to use?
TODO:
We have already copied the site into Jekyll in another repo
- Repo: https://gitlab.fabcloud.org/academany/fabacademy/site2
- Website (not live yet): http://academany.fabcloud.io/fabacademy/site2/
The only thing missing is linking to it (and maybe test a little bit)
- Change the DNS / Config to use the
site2
repo or - Rename site2 -> site - if that works?