The Proxima theme¶ ↑
Proxima is a Jekyll theme for GitHub Pages, with customizable colors and GitHub-like styling.
Usage¶ ↑
To use the Proxima theme:
-
Add the following to your site's
_config.yml
:remote_theme: dannyben/jekyll-theme-proxima
-
Optionally, if you'd like to preview your site on your computer, add the following to your site's
Gemfile
:gem "github-pages", group: :jekyll_plugins
Customizing¶ ↑
Configuration variables¶ ↑
Proxima will respect the following variables, if set in your site's _config.yml
:
title: [The title of your site] description: [A short description of your site's purpose] google_analytics: [Your Google Analytics tracking ID] header: background: '#789' color: white footer: border: '1px solid #eee'
Stylesheet¶ ↑
If you'd like to add your own custom styles:
-
Create a file called
/assets/css/style.scss
in your site -
Add the following content to the top of the file, exactly as shown:
--- --- @import "{{ site.theme }}";
-
Add any custom CSS (or Sass, including imports) you'd like immediately after the
@import
line
Layouts¶ ↑
If you'd like to change the theme's HTML layout:
-
Copy the original template from the theme's repository
-
Create a file called
/_layouts/default.html
in your site -
Paste the default layout content copied in the first step
-
Customize the layout as you'd like
Overriding GitHub-generated URLs¶ ↑
Templates often rely on URLs supplied by GitHub such as links to your repository or links to download your project. If you'd like to override one or more default URLs:
-
Look at the template source to determine the name of the variable. It will be in the form of
{{ site.github.zip_url }}
. -
Specify the URL that you'd like the template to use in your site's
_config.yml
. For example, if the variable wassite.github.url
, you'd add the following:github: zip_url: http://example.com/download.zip another_url: another value
-
When your site is built, Jekyll will use the URL you specified, rather than the default one provided by GitHub.
Note: You must remove the site.
prefix, and each variable name (after the github.
) should be indent with two space below github:
.
For more information, see the Jekyll variables documentation.
Previewing the theme locally¶ ↑
If you'd like to preview the theme locally (for example, in the process of proposing a change):
-
Clone down the theme's repository and
cd
into it -
Run
bundle
to install the necessary dependencies -
Run
run server
to start the preview server -
Visit {
localhost:3000
} in your browser to preview the theme