A website with editable content using markdown files stored on Github. Pages and partials are stored in the browser session storage for speed and to reduce the amount of calls to the Github API.
- Fork the Blurg repository from Github: https://github.com/impshum/blurg
- Change the description and website of your forked repo to your website title and url (more info below).
- Edit the php config file with your details (
/config.php
). - Edit the json config file with your details (
/config.json
). - Upload
/core
,config.php
,index.php
and.htaccess
to your server. - Edit the partials in
/contents/partials/
. - Edit/create the pages
/contents/
. - Start pushing to your repository.
- Config file is located in
/config.php
.
"github_username" => "impshum",
"preview_password" => "123"
- Config file is located in
/config.json
.
"url": "https://blurg.recycledrobot.co.uk",
"title": "Blurg",
"description": "A Beautiful Long Description",
"short_description": "Something",
"theme": "dark",
"maintenance_mode": false,
"show_house": true,
"show_coffee": true,
"show_ads": true
- These files are used to edit the pages, partials and to manage the images.
- Put all images to be used in pages in the
/contents/images/
directory.
├── contents
│ ├── images
│ │ └── thing.jpg
│ ├── partials
│ │ ├── blurgs.md
│ │ ├── coffee.md
│ │ ├── header.md
│ │ ├── index.md
│ │ └── menu.md
│ ├── one.md
│ ├── two.md
│ ├── three.md
│ └── four.md
If you check out https://blurg.recycledrobot.co.uk/?p=blurgs you can find other users websites made with Blurg. Work in progress...