1. Requirements

Doks uses npm to centralize dependency management, making it easy to update resources, build tooling, plugins, and build scripts:

  • Download and install Node.js (it includes npm) for your platform.

2. Start a new Doks project

Create a new site, change directories, install dependencies, and start development server.

2.1. Create a new site

Doks is available as a child theme, and a starter theme:

  • Use the Doks child theme, if you do not plan to customize a lot, and/or need future Doks updates.
  • Use the Doks starter theme, if you plan to customize a lot, and/or do not need future Doks updates.

Not quite sure? Use the Doks child theme.

2.1.1. Doks child theme

1
git clone https://github.com/v2rayA/v2raya.github.io-child-theme.git my-doks-site

2.1.2. Doks starter theme

1
git clone https://github.com/v2rayA/v2raya.github.io.git my-doks-site

2.2. Change directories

1
cd my-doks-site

2.3. Install dependencies

1
npm install

2.4. Start development server

1
npm run start

Doks will start the Hugo development webserver accessible by default at http://localhost:1313. Saved changes will live reload in the browser.

3. Other commands