Skip to content

Content for creating Uptick branded demo sites.

License

Notifications You must be signed in to change notification settings

uptick/uptick-demo-site

Repository files navigation

uptick-demo-site

npm version Downloads

Content for creating Uptick-branded demo sites, such as:

The demo site framework contains all the styles, a base template to use with Jekyll, and some common Javascript widgets.

Installation

Download the package:

npm install uptick-demo-site

Styles

Either import the styles in your preprocessed stylesheet:

@import "node_modules/uptick-demo-site/dist/uptick-demo-site";

Or host and include the built css directly:

<link href="/node_modules/uptick-demo-site/dist/uptick-demo-site.css" rel="stylesheet">

Widgets

Initialise the demo site components

import { init } from 'uptick-demo-site'

init()

Base Template

To use the base template, you will need to replace the default Jekyll _layouts directory in your config with the dist folder of this package:

_config.yml

layouts_dir: 'node_modules/uptick-demo-site/dist'

The base layout depends on the following templates existing in your Jekyll _includes folder:

  • head.html
  • required_static.html

Favicon

Copy favicon.png from this project's source directory into your jekyll root folder. Then add to the jekyll-seo-tag plugin to your project:

_config.yml

plugins:
  - jekyll-seo-tag

Usage

Base Template Customisation

A number of variables are used to customise the base template, which are set in your Jekyll config:

_config.yml

package_name: Cool Package
package_github_url: https://github.com/uptick/cool-package
package_npm_url: https://www.npmjs.com/package/cool-package

Source Code Previewer

To implement a source code previewer, use the following HTML mount:

<code
  class="script"
  data-source="static/demo-script.jsx"
>Loading ...</code>