jekyll-architect-theme
Go to file
Cyril Wong 6e0c411ea0
Update index.html
2023-11-01 21:09:50 +08:00
_layouts Update default.html 2023-11-01 21:08:41 +08:00
_posts Created the folder structure, and relevant changes to allow jekyll 2014-04-06 16:30:18 -03:00
images add assets 2013-12-10 11:06:32 -05:00
stylesheets Merge pull request #19 from ousia/master from jasonlong/architect-theme 2016-11-27 21:22:48 -02:00
.gitignore Add .jekyll-cache to .gitignore 2021-06-23 21:40:26 -03:00
Gemfile Migrating to Jekyll theme 2016-08-12 15:03:32 -03:00
Gemfile.lock Bump addressable from 2.7.0 to 2.8.1 2022-10-05 23:04:21 +00:00
README.md Fix link in contributing section of README 2018-01-13 09:41:49 -02:00
_config.yml Update _config.yml 2023-11-01 14:40:08 +08:00
index.html Update index.html 2023-11-01 21:09:50 +08:00
jekyll-architect-theme.gemspec Upgrade rake and bundler versions 2021-06-23 21:38:33 -03:00

README.md

Architect theme

This is a Jekyll theme that is an adaptation of @jasonlong's Architect theme on GitHub Pages.

This is the raw HTML and styles that are used for the Architect theme on GitHub Pages.

Getting Started

Prerequisites

To install this theme, jekyll is required to be installed on your system. Head over to the docs and install the four requirements (Ruby, RubyGems, Node.js and Python 2.7). If you're on a Mac system, it's likely the only package you'll need to install is Node.js

Once you've installed the requirements, run this command in your terminal:

$ sudo gem install jekyll

You'll also need to install the bundler package:

$ sudo gem install bundler

Downloading and Installing the theme

Download the theme

https://github.com/pietromenna/jekyll-architect-theme/archive/master.zip

Unzip it and use it as a regular jekyll folder.

$ unzip jekyll-architect-theme-master.zip

Get inside the newly extracted folder

$ cd jekyll-architect-theme-master

Install the dependencies

$ bundle install

Use it!

$ jekyll serve

Setup

Some important configuration can be done in the file _config.yml. Please, check the Setup section in that file.

baseurl

baseurl parameter is required in the case the site doesn't sit on the root of the domain. For example: https://pietromenna.github.io/jekyll-architect-theme

In the case above the baseurl should be set to "/jekyll-architect-theme".

In the case the site sits in the root, you can leave baseurl as empty "".

For more details read about Jekyll on its web page.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/pietromenna/jekyll-architect-theme.

Development

To set up your environment to develop this theme, run bundle install.

You theme is setup just like a normal Jelyll site! To test your theme, run bundle exec jekyll serve and open your browser at http://localhost:4000. This starts a Jekyll server using your theme. Add pages, documents, data, etc. like normal to test your theme's contents. As you make modifications to your theme and to your content, your site will regenerate and you should see the changes in the browser after a refresh, just like normal.

License

This work is licensed under a Creative Commons Attribution 4.0 International.