akkadotnet
/
getakka.net
зеркало из https://github.com/akkadotnet/getakka.net.git
1
0
Форкнуть 0
Код Задачи Пакеты Проекты Релизы Вики Активность
Trying out Assemble.io for site generation
429 коммитов 3 Ветки 0 Теги 33 MiB
JavaScript 71.4%
CSS 26.3%
Handlebars 0.9%
HTML 0.7%
Less 0.4%
Разное 0.3%
Перейти к файлу
Aaron Stannard 2beeab5b72
updated assemble.io dependencies so it can run on more modern NPM implementations 		2017-01-18 12:18:03 -08:00
.sass-cache CSS setup: 2015-04-08 16:36:08 -07:00
src Updated the Wire Serializer section (#221) 2017-01-18 11:50:03 -06:00
.gitignore CSS setup: 2015-04-08 16:36:08 -07:00
DOCS_GUIDELINES.md update docs guidelines 2015-04-09 15:30:05 -07:00
Gruntfile.js tweak gruntfile 2015-04-08 22:57:46 -07:00
LICENSE add Apache license 2016-12-19 14:15:52 -06:00
README.md cleanup + README + first docs guidelines 2015-04-09 15:20:08 -07:00
ThirdPartyNotices.md add third party notice 2016-12-20 19:58:50 -06:00
helper-gfm.js Assemble only rebuilds new files now. 2015-04-08 20:20:06 +02:00
helper-ifEq.js fixing active selectors & layout used in /docs/ files 2015-04-08 22:56:28 -07:00
marked-config.js add aaron docs + fix custom GFM parser breaking normal blockquotes 2015-04-09 14:46:40 -07:00
marked.js Working on markdown support 2015-02-15 13:20:49 +01:00
package.json updated assemble.io dependencies so it can run on more modern NPM implementations 2017-01-18 12:18:03 -08:00

README.md

Getting started

Contributing to the docs

We welcome contributions from anyone! Contributions to the docs can be done in two ways:

  1. Fork and Clone this repository, and send your changes in via pull request. Read and follow the docs guidelines here.
  2. You can use the Edit on GitHub link on each page of the live docs, this will take you to an edit mode version of the page here on GitHub. If you don't have commit rights for this repo, Github will allow you to make an ad hoc pull request right there.

Deployment

The live site will be built & redeployed whenever a change is made to the master branch of this repository.

This usually takes a few minutes, as we use a free build server.

Local usage / development

Install Node.JS

Follow the instructions on this page to install Node.

Make sure grunt-cli is installed

> npm install -g grunt-cli

Fork, then clone this repository.

> git clone https://github.com/<your name here>/getakka.net.git getakkanet
> cd getakkanet

Install the packages

> npm install -d

Build the site

# from within your local fork of the repo
> grunt

Once the site is generated, a browser will be opened, displaying the result.

Live reloads

When running the site locally, the grunt script will be watching the /src/ folder for changes.

If any changes are detected, this will trigger a regeneration of the content and your browser will be live reloaded.

Making CSS/style changes

Our custom styling is all done via SCSS.

Edit the appropriate "underscored" file in the /_scss. These SCSS files then get compiled automatically by grunt-contrib-compass into the screen.css file, which is then copied by grunt into /web.

Adding data for use in templates

To add sitewide data that can be used in any template/page, you can add it to src/_data/site.yml and it will then be accessible via Handlebars in all templates. For example, site.yml defines url, which is then accessed in the templates like so: {{site.url}}.

For more details / advanced usage, read the docs on options.data.

Markdown compatibility

We use Marked.JS for markdown rendering. Thus, any editor based on this will give you the best preview/edit experience, such as Atom or StackEdit.

Tools used

This site is built with Assemble.io static site generator, which uses the following tools to do its work: