Skip to content

code4sac/handbook

 
 

Repository files navigation

Brigade Ops

This is our forthcoming Brigade Ops Manual. Topics will include:

  • Getting Started (Home)
  • About Us
    • History
    • Mission, Vision and Values
    • Leadership
  • Events
    • Hack Nights
    • Hackathons
    • Special Events
  • Projects
    • Proposing Ideas
    • Selection Process
    • Development
    • Deployment
    • Marketing
    • Strategic Partnerships
  • Membership
    • Onboarding New Members
    • Core Team Requirements
  • Public Affairs
    • Government Relations
    • Nonprofit Stakeholders
    • Corporate Partnerships
  • Finances
  • Resources

DOCter README (from forked repo)

DOCter is a Jekyll template for quickly building out project pages and documentation.

DOCter Screenshot

See the demo

To run DOCter locally

Be sure to have Jekyll and Kramdown installed.

gem install jekyll
gem install kramdown

Fork and clone the repo:

git clone git@github.com:cfpb/DOCter.git
cd DOCter

Run Jekyll:

jekyll serve --baseurl ''

_config.yml

Options within the _config.yml file allow you to control the site's title, subtitle, logo, author information, and the left column navigation.

Project Page URL Structure

This is an excerpt from the Jekyll docs on configuring your URL for Project Pages.

Sometimes it's nice to preview your Jekyll site before you push your gh-pages branch to GitHub. However, the subdirectory-like URL structure GitHub uses for Project Pages complicates the proper resolution of URLs. Here is an approach to utilizing the GitHub Project Page URL structure (username.github.io/project-name/) whilst maintaining the ability to preview your Jekyll site locally.

  1. In _config.yml, set the baseurl option to /project-name -- note the leading slash and the absence of a trailing slash.
  2. When referencing JS or CSS files, do it like this: {{ site.baseurl }}/path/to/css.css -- note the slash immediately following the variable (just before "path").
  3. When doing permalinks or internal links, do it like this: {{ site.baseurl }}{{ post.url }} -- note that there is no slash between the two variables.
  4. Finally, if you'd like to preview your site before committing/deploying using jekyll serve, be sure to pass an empty string to the --baseurl option, so that you can view everything at localhost:4000 normally (without /project-name at the beginning): jekyll serve --baseurl ''

This way, you can preview your site locally from the site root on localhost, but when GitHub generates your pages from the gh-pages branch all the URLs will start with /project-name and resolve properly.

License

The project is in the public domain, and all contributions to it will be released as such. By submitting a pull request, you are agreeing to waive all rights to your contribution under the terms of the CC0 Public Domain Dedication.

If you contribute the open source work of others, please mark it clearly in your pull request.

Releases

No releases published

Packages

No packages published

Languages

  • CSS 82.2%
  • HTML 17.8%