Repository navigation
Create documentation for how to run our site with jekyll #1674
Description
Overview
Sometimes docker does not work, so we should have some documentation about how to use jekyll.
Action Items
- We are currently in the process of moving the old wiki to the new website-wiki repo, so we will not be making any changes or additions to the old wiki at this time. Thus, we will be adding wiki content through a different process now. Please read How to Contribute to the Wiki
- create a wiki article with the necessary steps
- test it out
- Make sure it is compatible with all systems (Mac, Windows, Iinux)
- share with dev team and have people review it
- close this issue
Plan
- Create a Gemfile.example (Gemfile is in .gitignore. See comments below for discussions about Gemfile and why it can't be checked in)
- create separate markdown on deploying in jekyll. Indicate in the document that if you run into issues, support may be limited and you may be asked to try Docker.
- Link to this file from contributing.md with same caveat as above.
Activity
jbubar commentedon May 30, 2021
@cnk @akibrhast do we need a Gemfile? and also, are there any flags to add to the
jekyll servecommand that would be useful?cnk commentedon May 31, 2021
To run Jekyll without Docker, one would need a Gemfile. The problem is, if there is a Gemfile in the repository, it interferers with the built in Gemfile in the Docker container.
Since the important thing is that our code match what GitHub is going to do with our files once pushed, I have been reluctant to do anything other than use the prebuilt, already working, Docker container. If you still want to be able to set up the HackForLA website project not to need Docker, I recommend storing a
Gemfile.examplein the repo - or in the wiki. That should hide it from GitHub pages. AND make sure you match supported versions of Jekyll. GH pages does not run the latest version of Jekyll - 3.9.0 NOT Jekyll 4. https://pages.github.com/versions/Sihemgourou commentedon Jun 24, 2021
github-actions commentedon Jun 24, 2021
adam-abundis commentedon Jul 7, 2021
25 remaining items
JessicaLucindaCheng commentedon Mar 27, 2023
@ethanstrominger
We are currently in the process of moving the old wiki to the new website-wiki repo, so we will not be making any changes or additions to the old wiki at this time. Thus, we will be adding wiki content through a different process now. Please read How to Contribute to the Wiki
github-actions commentedon Aug 2, 2024
github-actions commentedon Aug 9, 2024