Welcome to mirror list, hosted at ThFree Co, Russian Federation.

how-to-contribute.md « post « content « exampleSite - github.com/xianmin/hugo-theme-jane.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
blob: b69a2d6d56e790b4523ea4b14e6d0c8fc61d8eb9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
+++
title = "How to Contribute"
description = ""
tags = [
    "go",
    "golang",
    "hugo",
    "Contribute",
]
date = "2021-10-15"
categories = [
    "Development",
    "index",
]
+++

## Contributing to Jane

There are many ways to contribute to the Jane theme: submitting pull requests, reporting issues, providing new translations, and creating suggestions.


## Build and Run

If you want to understand how Jane works, you'll want to get the source, build it, and run locally.

### Getting the sources

```bash
git clone https://github.com/xianmin/hugo-theme-jane.git
```

### Prerequisites

You need install the `Hugo_extended` version to use [Hugo Pipes](https://gohugo.io/hugo-pipes/).

We recommend that you use VSCode. And if you edit `.html` files, recommend you install prettier and [prettier-plugin-go-template](https://github.com/NiklasPor/prettier-plugin-go-template) **globally** . And open `Prettier: Resolve Global Modules` in your VSCode Settings.

```bash
npm install -g prettier prettier-plugin-go-template
```


### Watch example Site

```bash
hugo server --contentDir='./exampleSite/content' --config='dev-config.toml'
```


## Directory Structure

- `layouts/` Stores templates in the form of .html files that specify how views of your content will be rendered into a static website.
- `assets/` stores all the scss & js **source files**, `Hugo Pipes` will bundle them to `resources/` folder.