Homepage for the bpkg project http://bpkg.io
CSS HTML Ruby
Latest commit 70acfad Feb 8, 2017 @pepa65 pepa65 committed with jwerle Added commandline option --version (#31)
* First submission of tldr-bash-client

* Added commandline option --version
Permalink
Failed to load latest commit information.
_drafts Started using "Jekyll Bootstrap" to create things easier Jun 2, 2014
_includes Make sure the css link is working Jul 4, 2016
_layouts Started using "Jekyll Bootstrap" to create things easier Jun 2, 2014
_plugins Started using "Jekyll Bootstrap" to create things easier Jun 2, 2014
_posts Added commandline option --version (#31) Feb 8, 2017
archive Changed the directory structure, adapted some meta info on the site Jun 2, 2014
assets Made the META part of each package stand out from the rest of the site Jun 17, 2014
feed Changed the directory structure, adapted some meta info on the site Jun 2, 2014
guidelines Updated ways in how the site handle packages and wrote a package subm… Jun 2, 2014
packages Made the "Packages by Name" page show the name AND description of eac… Jun 17, 2014
pages Changed the directory structure, adapted some meta info on the site Jun 2, 2014
submit No need for {JB Setub whatver fahsuf fji23ofj 😡 Jun 17, 2014
.gitignore Started using "Jekyll Bootstrap" to create things easier Jun 2, 2014
404.html Started using "Jekyll Bootstrap" to create things easier Jun 2, 2014
CNAME Added CNAME file (closes #1) Jun 2, 2014
README.md Made the site in a way that it can browse packages (just need create … Jun 2, 2014
Rakefile Started using "Jekyll Bootstrap" to create things easier Jun 2, 2014
_config.yml Linked this page to `bpkg`s Disqus comment account Jun 16, 2014
about.md Started with a blank Jekyll template Jun 1, 2014
index.md link changed to functional raw link Mar 11, 2016
sitemap.txt Started using "Jekyll Bootstrap" to create things easier Jun 2, 2014

README.md

bpkg.github.io

bpkg is a lightweight bash package manager. This repository contains the source code of it's homepage.

Links:

Dependencies

This website was made with the Jekyll engine, so it depends on a few Ruby Gems. To install them, run the following command.

$ gem install jekyll

It might take a while to finish, but once it does you're ready to go.

How to edit

To make changes to the page or run it locally, clone this GitHub repository and make sure you have installed the dependencies above.

Then, it's a matter of editing pages and running rake tasks. Here's a rundown of possible commands (thanks to this great quickstart on Jekyll):


$ rake preview

Builds the entire site to a local folder _site and launches a webserver to preview it.

To see the full site, point your browser to localhost:40000.

If you make any changes on any files, it will regenerate the website automatically.


$ rake post title="Hello, World!"

Creates a new post. It will create a file _posts/YYYY-MM-DD-title.md, where the date is the current, by default.

No further changes are required, the post will get automatically inserted on the site.


$ rake page name="about"

Creates a new page. It will create the file ./about/index.html.

$ rake page name="about.html"

Alternative way to create a new page, on this case it will be ./about.html.

Notes

  • When producing content (writing pages/posts) keep in mind this useful guide. It tells how to include images, display post excerpts and highlight code snippets.
  • If you plan on further customizing the blog, it's highly recommended to read this 10-minute introduction to Jekyll.
  • If you change settings on the file _config.yml, automatic regeneration won't work - you'll have to run the command rake preview again.

Credits

This site uses Jekyll Bootstrap with a heavily customized version of the_program theme, originally made by Yuya Saito.