This is the source code of the Dogescript homepage.
README specifies how to update the website and do maintenance tasks.
If you're after the Dogescript language itself, see the following links:
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
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
To see the full site, point your browser to
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
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
$ rake page name="about.html"
Alternative way to create a new page, on this case it will be
$ rake wiki name="user/repo"
Updates the GitHub Wiki pages from GitHub
repo into the directory
It works by either cloning the remote wiki repository (if it doesn't exist
./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.
This repository has lots of files, each with it's well-defined importance.
Please prefer editing the files below:
||Place custom CSS at the end of it|
||All reusable pieces of HTML used everywhere|
- 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
The following is a list of sites that inspired me, both on the content and interface: