code4lib / 2019.code4lib.org

conference website for 2019
https://2019.code4lib.org
4 stars 8 forks source link
code4lib jekyll-site

2019.code4lib.org

Intro

This site was developed by the Code4Lib 2019 Conference Committee Website Working Group based on a design by the 2016 working group. The site was designed to provide a comprehensive overview of the Code4Lib 2019 Annual Conference. A great deal of conference and organizational info can be found on the Code4Lib Wiki and the Code4Lib Site, but this site should serve as a gateway to the various sources of Code4Lib information while providing visitors with a user-friendly way to find conference-specific info.

This site was designed with future users in mind, so the group chose platforms that would be accessible to a wide range of users: Jekyll and GitHub Pages.

Resources

More details are available in the GitHub wiki.

About Jekyll

Jekyll is a Ruby gem that generates static websites from markdown, HTML, and other formats. See the official Jekyll documentation for details.

Contributing

Steps for contributing have been documented in the wiki on the 2016 site's GitHub page and will be updated as needed.

See a list of open issues. The following example uses "issue#3" as a subject. That's the branch name and is used in the commit message.

Setup

  1. git clone the repo from GitHub
  2. cd to repo root and git pull
  3. bundle install
  4. Continue with step 3 below

Contributing

  1. Make sure you're on the main branch
    • git checkout main
  2. Make sure your main branch is up to date
    • git pull origin main
  3. Start up jekyll
  4. Create a new branch for your changes
    • git checkout -b issue#3
  5. Make changes, check http://localhost:4000 to see your changes live
  6. Add your changed files
    • git add {changed-files}
  7. Commit your changes with a fancy message
    • git commit -m "fixes issue #3"
  8. Add your branch to the repo
    • git push --set-upstream origin issue#3
  9. Switch back to the main branch
    • git checkout main
  10. Go to https://github.com/code4lib/2019.code4lib.org
  11. Make a pull request base:main and compare:issue-3
  12. Wait for someone to test your changes and merge the pull request
  13. Do the dance of joy

Managing Pull Requests

  1. Follow steps 1 - 3 above
  2. Get any remote branches
    • git fetch
  3. Switch to the branch in question
    • git checkout BRANCHNAME
  4. bundle exec jekyll serve
  5. Check http://localhost:4000 that nothing is broken
  6. Merge that branch into main (easiest to manage on the GitHub site)

Dat

As an experiment the site is also available via Dat which you can view in the Beaker Browser at dat://2019.code4lib.org. If you would like to clone the site you'll need to install Dat and then:

dat clone dat://2019.code4lib.org

If you want to update the Dat site you'll need to import the secret key from a friend:

dat keys import < 2019.code4lib.org

Then you'll need to:

rm -rf _site
dat clone dat://2019.code4lib.org _site
jekyll build
cd _site
dat sync