diff --git a/content/patterns/library-setup.md b/content/patterns/library-setup.md index 2be8f34..15252cd 100644 --- a/content/patterns/library-setup.md +++ b/content/patterns/library-setup.md @@ -38,7 +38,7 @@ theme = "infusion" {{}} * **title** — This is the library's name, like "Megacorp 5000 Pattern Library". You don't have to include the term "pattern library" if you don't want to. For **Infusion's** version of **Infusion**, the `title` is, naturally, _Infusion_ :-) -* **baseURL** — This is the root of the live site. Typically you will publish the site to Github Pages, so this should be the base URL for your Github Pages site. More information is available in {{% pattern "Serving" %}}. +* **baseURL** — This is the root of the live site. Typically you will publish the site to Github Pages, so this should be the base URL for your Github Pages site. * **theme** — This is the theme the library is using. Don't change this from "infusion". * **description** — This is a short description of the library and comes under the logo. You can include HTML like `` and ``. * **codePenUser** — If you want to embed codePens in your pattern files, you need to supply a codePen username here. diff --git a/content/patterns/serving.md b/content/patterns/serving.md index db82f81..e5bd0b4 100644 --- a/content/patterns/serving.md +++ b/content/patterns/serving.md @@ -35,3 +35,21 @@ On the (default) master branch run: {{}}npm run host{{}} You should now be able to find a "live" version of your library at `[your user name].github.io/[your library repo name]`. + ++++ +title = "Serving" ++++ + +## Serving locally + +While you're creating content for your library, you'll probably want to see what the finished product looks like. Fortunately, **Infusion** is easy to serve locally using the `serve` command: + +{{}}npm run serve{{}} + +This will serve your working library from `localhost:1313` (the exact URL will be determined by what's in your `baseURL` and will be revealed to you by your terminal). Whenever you make changes to your library's files, the site will automatically rebuild. No need to refresh the web page! + +## Publishing on Github Pages + +**Infusion** creates a `/docs` folder containing the latest version of your library whenever you run `npm run build` or do a `git commit`. This folder can be made the source for your Github Pages site by selecting it under **Settings → Github Pages → Source** in the web interface. + +Then, whenever you push to master, you will also be updating the site found at your Github Pages URL, in the format `[your user name].github.io/[your library repo name]`. See {{% pattern "Library setup" %}} for adding this URL to your `config.toml` file. If you are having trouble working out your Github Pages URL, [this tool may help](https://drastudio.github.io/url-generator/). diff --git a/package.json b/package.json index 1f5af7c..4581b5e 100644 --- a/package.json +++ b/package.json @@ -1,14 +1,14 @@ { - "name": "inclusive-pattern-library", + "name": "infusion", "version": "0.0.1", "description": "An inclusive pattern library builder for documenting inclusive interface design", "main": "index.js", "scripts": { - "getURL": "git remote -v | sed -n '/push/p' | awk '{print $2}' | sed 's/.*:\\(.*\\).git/\\1/' | awk -F\"/\" '{print $1\".github.io/\"$2}'", "test": "echo \"Error: no test specified\" && exit 1", "serve": "hugo server", "clean": "rm -rf content && mkdir content && mkdir content/patterns && hugo new patterns/pattern.md && hugo new _index.md", - "build": "hugo" + "build": "hugo", + "precommit": "npm run build" }, "repository": { "type": "git",