much website very pages
JavaScript CSS HTML Ruby Other
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
_drafts
_includes
_layouts
_plugins
_posts
archive
assets
categories
live
pages
tags
wiki
.gitignore
404.md
CNAME
README.md
Rakefile
_config.yml
atom.xml
index.md
rss.xml
sitemap.txt

README.md

dogescript.github.io

This is the source code of the Dogescript homepage. This README specifies how to update the website and do maintenance tasks.

If you're after the Dogescript language itself, see the following links:

Intro

This homepage is a static site; meaning that for each modification you have to regenerate the website and upload it.

It uses the Jekyll engine to automate this process. Since Jekyll is written in Ruby you have to install a few Ruby packages (called Ruby Gems).

Finally, there are some rake tasks to ease the whole process of maintaining the website

Dependencies

You must have the RubyGems package manager installed. Note that it comes by default on many distributions, so check if it exists with the following command:

$ gem --version

Then, to install rake (Ruby's version of make), Jekyll and all dependencies to run this site, do the following command:

$ gem install rake 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 running rake tasks and editing files. 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:4000.

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.


$ rake wiki name="user/repo"

Updates the GitHub Wiki pages from GitHub user and repo into the directory ./wiki.

It works by either cloning the remote wiki repository (if it doesn't exist on ./wiki yet) or pulling the latest update (if it's already there). Then it adds a small YAML metadata header to each page, making it able to work as a page.

So when you visit ./wiki it nicely shows all wiki pages.

Important files

This repository has lots of files, each with it's well-defined importance.

Please prefer editing the files below:

file role
assets/theme/the-minimum/css/style.css Place custom CSS at the end of it
_includes/themes/the-minimum/*.html All reusable pieces of HTML used everywhere

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_minimum theme, made by Yuya Saito. For more info on it, see the file assets/themes/the-minimum/readme.markdown.

The following is a list of sites that inspired me, both on the content and interface: