Quick. The fastest and easiest way to create a GitHub Pages website for your project.
The Quick theme magically transforms your README.md
into a GitHub Pages site, applying clean and visually appealing styles.
Just see it yourself — this page is the same README.md
file you’re reading, but with the Quick theme applied:
Quick start
-
Make sure a
README.md
file exists in the root directory of your repo, and GitHub Pages is enabled in your repository settings. - Create a file named
_config.yml
in the root directory of your repository. The file should contain the following content:remote_theme: devich/quick@0.0.1
- That’s it! There is no step 3. You now have a GitHub Pages website that’s based on your
README.md
file. The changes will take effect some time after you commit and push your updates to the repository. Enjoy your new website!
Looking for a simple landing page for your project?
No problem! You’re not restricted to using readme.md
as the index page of your site. Simply create a file named index.md
, and this theme will use it as the home page. Feel free to create as many pages as you want and link them within your site.
For instance, if you need a home page and an ‘About’ page, create files named index.md
and about.md
. Inside the index.md
file, you can link to your ‘About’ page like this:
[About this project](about)
Fine tuning
Additional settings in _config.yml
You can set additional parameters for the site in the _config.yml
file.
The following options are available:
lang:
sets the language of the site. E.g.en-US
,uk
,pl
,fr-CA
and so on. The default value isen-US
.bg_color:
sets the background color of your website. Can bedark
,light
orauto
. The default value isauto
.theme_color:
sets the main accent color for buttons, links, etc. It can bered
,pink
,fuchsia
,purple
,violet
,indigo
,blue
,azure
,cyan
,jade
,green
,lime
,yellow
,amber
,pumpkin
,orange
,sand
,grey
,zinc
or The default value isslate
.azure
.title:
sets the title of the site. If not set, your repository name will be used.description
: sets the meta description tag, which typically contains a concise, relevant summary of the page’s content.keywords
: sets keywords for the page, separated with commas.gtag
: sets your Google Analytics tag if needed (e.g. G-A1BCDEFGHI).
Alternatively, you can copy the contents of the _config.yml
file from the theme repository into your own _config.yml
file. This will give you access to all available options at once.
Ignoring
If there’s a block in the README.md
file that you don’t want to display on the GitHub Pages site, you can format this block as HTML and assign the class="ignore"
attribute to it.
This paragraph will not be displayed
on the site because it has an "ignore"
class.
<p class="ignore">
This paragraph <a href="https://devich.github.io/quick/">will not be
displayed</a> on the site because it has an <code>"ignore"</code> class.
</p>
More customization
If you need to use your own CSS styles, create a file assets/css/custom.css
in your repository and add your styles to it.
For a custom favicon, just place your file in PNG
format at assets/img/favicon.png
.
For full control, clone this repository and modify the template as you need.