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

github.com/zzossig/hugo-theme-zdoc.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorzzossig <zzossig@gmail.com>2020-10-20 16:54:42 +0300
committerzzossig <zzossig@gmail.com>2020-10-20 16:54:42 +0300
commitd7c5ec7bd0b5a009fa846d13f79c61d25842e93e (patch)
tree36244f4f9adf1a1fa7e27b7d1308c00592d4ee59 /README.md
parent4e0ff9dba43882c8e24b6afe75d4811e5df09e90 (diff)
readme changed, new shortcodes, new param
new param - wideViewAsDefault new shortcode - codeblock - tab
Diffstat (limited to 'README.md')
-rw-r--r--README.md381
1 files changed, 11 insertions, 370 deletions
diff --git a/README.md b/README.md
index 34d65d0..908c9dd 100644
--- a/README.md
+++ b/README.md
@@ -1,383 +1,24 @@
-## Zdoc theme for Hugo
+## ๐Ÿ“„ Documentation
-I'll document all the updates soon.
+[https://zzo-docs.vercel.app/zdoc](https://zzo-docs.vercel.app/zdoc)
-## Table of contents
+## โค๏ธ Sponsor
-* [Features](#features)
-* [Minimum Hugo version](#minimum-hugo-version)
-* [Installation](#installation)
-* [Updating](#updating)
-* [Run example site](#run-example-site)
-* [Configuration](#configuration)
-* [How to make Doc](#how-to-make-doc)
-* [Multi Language](#multi-language)
-* [Favicon](#favicon)
-* [Shortcodes](#shortcodes)
+Your support will be of great help in maintaining the project.
-## Features
+<a href="https://www.buymeacoffee.com/zzossig" target="_blank"><img src="https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png" alt="Buy Me A Coffee" style="height: 41px !important;width: 174px !important;box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;-webkit-box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;" ></a>
+
+## ๐Ÿ’ก Features
* Dark mode
-* A mobile menu
-* Simple documentation
+* Mobile menu
* Search
* Search Engine Optimization(SEO)
* Multilingual (i18n)
* Responsive design
+* Fast code highlighting
+* Blog support
## Minimum Hugo version
-Hugo version 0.60.0 or higher is required.
-
-## Installation
-
-First of all, You need to add config files.
-Follow the [Configuration](#configuration) step.
-
-Then, You can download and unpack the theme manually from Github but it's easier to use git to clone the repo.
-
-From the root of your site:
-
-```bash
-$ git clone https://github.com/zzossig/hugo-theme-zdoc.git themes/zdoc
-```
-
-If you use git to version control your site, highly recommended, it's best to add the zdoc theme as a submodule.
-
-From the root of your site:
-
-```bash
-git submodule add https://github.com/zzossig/hugo-theme-zdoc.git themes/zdoc
-```
-
-## Updating
-
-From the root of your site:
-
-```bash
-git submodule update --remote --merge
-```
-
-## Run example site
-
-From the root of themes/zdoc/exampleSite:
-
-```bash
-hugo server --themesDir ../..
-```
-
-## Configuration
-
-0. From the root of your site: delete config.toml file and add the files below
-
-1. config folder structure. Keep in mind the underscore on the `_default` folder
-
-```bash
-root
-โ”œโ”€โ”€ config
-โ”‚ย ย  โ”œโ”€โ”€ _default
-โ”‚ย ย  โ”‚ย ย  โ”œโ”€โ”€ config.toml
-โ”‚ย ย  โ”‚ย ย  โ”œโ”€โ”€ languages.toml
-โ”‚ย ย  โ”‚ย ย  โ”œโ”€โ”€ menus.en.toml
-โ”‚ย ย  โ”‚ย ย  โ”œโ”€โ”€ params.toml
-```
-
-2. config.toml
-
-```bash
-baseURL = "http://example.org"
-title = "Hugo ZDoc Theme"
-theme = "zdoc"
-
-defaultContentLanguage = "en"
-defaultContentLanguageInSubdir = true
-hasCJKLanguage = true
-
-copyright = "&copy;{year}, All Rights Reserved"
-timeout = 10000
-enableEmoji = true
-paginate = 13
-rssLimit = 100
-
-googleAnalytics = ""
-
-[markup]
- [markup.goldmark]
- [markup.goldmark.renderer]
- hardWraps = true
- unsafe = true
- xHTML = true
- [markup.highlight]
- codeFences = true
- lineNos = true
- lineNumbersInTable = true
- noClasses = false
- [markup.tableOfContents]
- endLevel = 4
- ordered = false
- startLevel = 2
-
-[outputs]
- home = ["HTML", "RSS", "JSON"]
-
-[taxonomies]
- tag = "tags"
-```
-
-3. languages.toml
-
-```bash
-[en]
- title = "Hugo ZDoc Theme"
- languageName = "English"
- weight = 1
-
-[ko]
- title = "Hugo ZDoc Theme"
- languageName = "ํ•œ๊ตญ์–ด"
- weight = 2
-```
-
-4. menus.en.toml
-
-You shoud make your own menu.
-
-```bash
-[[main]]
- identifier = "docs"
- name = "Docs"
- url = "docs"
- weight = 1
-
-[[main]]
- identifier = "updates"
- name = "Updates"
- url = "updates"
- weight = 2
-
-[[main]]
- identifier = "blog"
- name = "Blog"
- url = "blog"
- weight = 3
-...
-```
-
-5. params.toml
-
-```bash
-logo = true # Logo that appears in the site navigation bar.
-logoText = "ZDoc" # Logo text that appears in the site navigation bar.
-logoType = "short" # long, short
-description = "The ZDoc theme for Hugo example site." # for SEO
-
-themeOptions = ["light", "dark"] # select options for site color theme
-
-useFaviconGenerator = true # https://www.favicon-generator.org/
-
-enableSearch = true
-enableLangChange = true
-enableDarkMode = true
-enableBreadcrumb = true
-enableToc = true
-enableMenu = true
-enableNavbar = true
-enableFooter = true
-showPoweredBy = true
-
-paginateWindow = 1 # setting it to 1 gives 7 buttons, 2 gives 9, etc. If set 1: [1 ... 4 5 6 ... 356] [1 2 3 4 5 ... 356] etc
-taxoPaginate = 13 # items per page
-taxoGroupByDate = "2006" # "2006-01": group by month, "2006": group by year
-
-github = "https://github.com/zzossig/hugo-theme-zdoc"
-```
-
-## How to make doc
-
-1. Make a folder in the `content` folder. The folder will be appeared in the menu. I'm going to make `doc` folder.
-
-2. Make a `_index.md` file in the `doc` folder.
-
-```yaml
----
-title: "Documentation"
-description: "test doc index"
-date: 2020-01-11T14:09:21+09:00
----
-
-The content here is appeared when you click the manu. So called overview page.
-```
-
-3. There are two types of pages. One is a single page and the other is collapsible page.
-
-- single page - Just make a md file in the `doc` folder
-
- ```yaml
- ---
- title: "Content Formats"
- description: "test post"
- date: 2020-01-28T00:38:51+09:00
- draft: false
- weight: 1
- ---
-
- *Markdown here*
-
- ```
-
-- collapsible page - We need to make a new folder inside the doc folder. I'll make a folder named `gettingstarted`. And then, make a `_index.md` file.
-
- `root/content/doc/gettingstarted/_index.md`
-
- ```yaml
- ---
- title: "Getting started"
- description: "test post index"
- date: 2020-01-28T00:36:39+09:00
- draft: false
- weight: 2
- collapsible: true
- ---
-
- ```
-
- The weight defines the order of the post. If the `collapsible` param set `true`, you can see the menu that can be collapsible.
-
-- Make more pages in the collapsible section. Something like `Getting Started`, `Installation`, `Basic usage`, etc... For example, make a file at `root/content/doc/gettingstarted/installation.md`
-
- ```yaml
- ---
- title: "Frontmatter"
- description: "test post"
- date: 2020-01-28T00:36:14+09:00
- draft: false
- ---
-
- *Markdown here*
-
- ```
-
-4. Finally, make a menu in the file at `root/config/_default/menus.en.toml`.
-
-You should make your own menu.
-
-```toml
-[[main]]
- identifier = "docs"
- name = "Docs"
- url = "docs"
- weight = 1
-
-[[main]]
- identifier = "updates"
- name = "Updates"
- url = "updates"
- weight = 2
-
-[[main]]
- identifier = "blog"
- name = "Blog"
- url = "blog"
- weight = 3
-```
-
-## Multi Language
-
-The default language of this theme is English. If you want to use another language, follow these steps
-
-1. Make a menu file.
-
-```bash
-root
-โ”œโ”€โ”€ config
-โ”‚ย ย  โ”œโ”€โ”€ _default
-โ”‚ย ย  โ”‚ย ย  โ”œโ”€โ”€ ...
-โ”‚ย ย  โ”‚ย ย  โ”œโ”€โ”€ menus.ko.toml
-```
-
-```bash
-config/_default/menus.ko.toml
-
-[[main]]
- identifier = "about"
- name = "about"
- url = "/about/"
- weight = 1
-
-[[main]]
- identifier = "archive"
- name = "archive"
- url = "/archive/"
- weight = 2
-...
-```
-
-2. Make a content file. Add your language code before the md extension.
-
-```bash
-hugo new about/index.ko.md
-hugo new posts/markdown-syntax.ko.md
-...
-```
-
-3. Make an i18n file.
-
-```bash
-i18n/ko.toml
-
-[search-placeholder]
-other = "๊ฒ€์ƒ‰..."
-
-[summary-dateformat]
-other = "2006๋…„ 01์›” 02์ผ"
-
-[tags]
-other = "ํƒœ๊ทธ"
-
-...
-```
-
-4. Edit config.toml file.
-
-```bash
-defaultContentLanguage = "ko"
-defaultContentLanguageInSubdir = true
-hasCJKLanguage = true
-```
-
-## Favicon
-
-Put your `favicon.ico` file under the static folder. The filename should be `favicon` and the extension should be `ico`.
-
-### Using favicon-genarator
-
-If you want to support mobile favicon, use [favicon-generator](https://www.favicon-generator.org/).
-
-- Make favicons from favicon-generator site.
-- Make a folder at `root/static/favicon`
-- Unzip the generated favicon to that folder.
-- Set the config param `useFaviconGenerator` to `true`
-
-## Shortcodes
-
-### alert
-
-```bash
-{{< alert theme="warning" >}} # warning, success, info, danger
-**this** is a text
-{{< /alert >}}
-```
-
-### expand
-
-```bash
-{{< expand "Expand me" >}}Some Markdown Contents{{< /expand >}}
-```
-
-### notice
-
-```bash
-{{< notice success "This is title" >}} # success, info, warning, error
-success
-{{< /notice >}}
-```
+Hugo version 0.65.0 or higher is required.