fluencelabs/tendermint
1
0
Fork 0
mirror of https://github.com/fluencelabs/tendermint synced 2025-04-25 06:42:16 +00:00
Code Issues Projects Releases Wiki Activity

docs: Add assets/instructions for local docs build (#2453)

Browse Source 
* ungitignore
* add docs/.vuepress to enable local builds
* config.js needs to be here, one less step
* docs: make spec in sidebar nicer
* docs: local build instructions
This commit is contained in:
Zach 2018-09-21 07:39:55 -04:00 committed by Alexander Simmerl
parent 8d50bb9dad
commit 886a83dfb8
18 changed files with 4759 additions and 17 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
.gitignore vendored
View File

@ -14,7 +14,6 @@ test/p2p/data/
test/logs test/logs
coverage.txt coverage.txt
docs/_build docs/_build
docs/.vuepress
docs/dist docs/dist
*.log *.log
abci-cli abci-cli
@ -42,4 +41,4 @@ terraform.tfstate
terraform.tfstate.backup terraform.tfstate.backup
terraform.tfstate.d terraform.tfstate.d
.vscode .vscode

7
docs/config.js → docs/.vuepress/config.js
View File

@ -66,18 +66,19 @@ module.exports = {
"/app-dev/ecosystem" "/app-dev/ecosystem"
] ]
}, },
{
title: "Tendermint Spec", title: "Tendermint Spec",
collapsable: true, collapsable: true,
children: [ children: [
"/spec/README", "/spec/",
"/spec/blockchain/blockchain", "/spec/blockchain/blockchain",
"/spec/blockchain/encoding", "/spec/blockchain/encoding",
"/spec/blockchain/state", "/spec/blockchain/state",
"/spec/consensus/abci", "/spec/software/abci",
"/spec/consensus/bft-time", "/spec/consensus/bft-time",
"/spec/consensus/consensus", "/spec/consensus/consensus",
"/spec/consensus/light-client", "/spec/consensus/light-client",
"/spec/consensus/wal", "/spec/software/wal",
"/spec/p2p/config", "/spec/p2p/config",
"/spec/p2p/connection", "/spec/p2p/connection",
"/spec/p2p/node", "/spec/p2p/node",

17
docs/.vuepress/dist/404.html vendored Normal file
View File

@ -0,0 +1,17 @@
<!DOCTYPE html>
<html lang="en-US">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>VuePress</title>
<meta name="description" content="">
<link rel="preload" href="/assets/css/1.styles.c01b7ee3.css" as="style"><link rel="preload" href="/assets/js/app.48f1ff5f.js" as="script"><link rel="prefetch" href="/assets/js/0.7c2695bf.js">
<link rel="stylesheet" href="/assets/css/1.styles.c01b7ee3.css">
</head>
<body>
<div id="app" data-server-rendered="true"><div class="theme-container"><div class="content"><h1>404</h1><blockquote>Looks like we've got some broken links.</blockquote><a href="/" class="router-link-active">Take me home.</a></div></div></div>
<script src="/assets/js/app.48f1ff5f.js" defer></script>
</body>
</html>

1
docs/.vuepress/dist/assets/css/1.styles.c01b7ee3.css vendored Normal file
View File

File diff suppressed because one or more lines are too long

1
docs/.vuepress/dist/assets/img/search.83621669.svg vendored Normal file
View File

@ -0,0 +1 @@
<?xml version="1.0" encoding="UTF-8"?><svg xmlns="http://www.w3.org/2000/svg" width="12" height="13"><g stroke-width="2" stroke="#aaa" fill="none"><path d="M11.29 11.71l-4-4"/><circle cx="5" cy="5" r="4"/></g></svg>
Side by Side

After

Width:  |  Height:  |  Size: 216 B

1
docs/.vuepress/dist/assets/js/0.7c2695bf.js vendored Normal file
View File

@ -0,0 +1 @@
(window.webpackJsonp=window.webpackJsonp||[]).push([[0],{136:function(e,t,s){"use strict";s.r(t);var n=s(0),r=Object(n.a)({},function(){this.$createElement;this._self._c;return this._m(0)},[function(){var e=this.$createElement,t=this._self._c||e;return t("div",{staticClass:"content"},[t("h1",{attrs:{id:"hello-vuepress"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#hello-vuepress","aria-hidden":"true"}},[this._v("#")]),this._v(" Hello VuePress")])])}],!1,null,null,null);t.default=r.exports}}]);

8
docs/.vuepress/dist/assets/js/app.48f1ff5f.js vendored Normal file
View File

File diff suppressed because one or more lines are too long

17
docs/.vuepress/dist/index.html vendored Normal file
View File

@ -0,0 +1,17 @@
<!DOCTYPE html>
<html lang="en-US">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Hello VuePress</title>
<meta name="description" content="">
<link rel="preload" href="/assets/css/1.styles.c01b7ee3.css" as="style"><link rel="preload" href="/assets/js/app.48f1ff5f.js" as="script"><link rel="preload" href="/assets/js/0.7c2695bf.js" as="script">
<link rel="stylesheet" href="/assets/css/1.styles.c01b7ee3.css">
</head>
<body>
<div id="app" data-server-rendered="true"><div class="theme-container no-sidebar"><header class="navbar"><div class="sidebar-button"><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" role="img" viewBox="0 0 448 512" class="icon"><path fill="currentColor" d="M436 124H12c-6.627 0-12-5.373-12-12V80c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12zm0 160H12c-6.627 0-12-5.373-12-12v-32c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12zm0 160H12c-6.627 0-12-5.373-12-12v-32c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12z"></path></svg></div><a href="/" class="home-link router-link-exact-active router-link-active"></a><div class="links"><div class="search-box"><input aria-label="Search" autocomplete="off" spellcheck="false" value=""><!----></div><!----></div></header><div class="sidebar-mask"></div><div class="sidebar"><!----><!----></div><div class="page"><div class="content"><h1 id="hello-vuepress"><a href="#hello-vuepress" aria-hidden="true" class="header-anchor">#</a> Hello VuePress</h1></div><div class="page-edit"><!----><!----></div><!----></div></div></div>
<script src="/assets/js/0.7c2695bf.js" defer></script><script src="/assets/js/app.48f1ff5f.js" defer></script>
</body>
</html>

35
docs/DOCS_README.md
View File

@ -24,7 +24,7 @@ on the website.
## Config.js ## Config.js
The [config.js](./config.js) generates the sidebar and Table of Contents The [config.js](./.vuepress/config.js) generates the sidebar and Table of Contents
on the website docs. Note the use of relative links and the omission of on the website docs. Note the use of relative links and the omission of
file extensions. Additional features are available to improve the look file extensions. Additional features are available to improve the look
of the sidebar. of the sidebar.
@ -59,9 +59,36 @@ to send users to the GitHub.
## Building Locally ## Building Locally
Not currently possible but coming soon! Doing so requires To build and serve the documentation locally, run:
assets held in the (private) website repo, installing
[VuePress](https://vuepress.vuejs.org/), and modifying the `config.js`. ```
# from this directory
npm install
npm install -g vuepress
```
then change the following line in the `config.js`:
```
base: "/docs/",
```
to:
```
base: "/",
```
Finally, go up one directory to the root of the repo and run:
```
# from root of repo
vuepress build docs
cd dist/docs
python -m SimpleHTTPServer 8080
```
then navigate to localhost:8080 in your browser.
## Consistency ## Consistency

4670
docs/package-lock.json generated Normal file
View File

File diff suppressed because it is too large Load Diff

2
docs/spec/README.md
View File

@ -1,4 +1,4 @@
# Tendermint Specification # Overview
This is a markdown specification of the Tendermint blockchain. This is a markdown specification of the Tendermint blockchain.
It defines the base data structures, how they are validated, It defines the base data structures, how they are validated,

2
docs/spec/blockchain/blockchain.md
View File

@ -1,4 +1,4 @@
# Tendermint Blockchain # Blockchain
Here we describe the data structures in the Tendermint blockchain and the rules for validating them. Here we describe the data structures in the Tendermint blockchain and the rules for validating them.

2
docs/spec/blockchain/encoding.md
View File

@ -1,4 +1,4 @@
# Tendermint Encoding # Encoding
## Amino ## Amino

2
docs/spec/blockchain/state.md
View File

@ -1,4 +1,4 @@
# Tendermint State # State
## State ## State

2
docs/spec/consensus/bft-time.md
View File

@ -1,4 +1,4 @@
# BFT time in Tendermint # BFT Time
Tendermint provides a deterministic, Byzantine fault-tolerant, source of time. Tendermint provides a deterministic, Byzantine fault-tolerant, source of time.
Time in Tendermint is defined with the Time field of the block header. Time in Tendermint is defined with the Time field of the block header.

2
docs/spec/consensus/light-client.md
View File

@ -1,4 +1,4 @@
# Light client # Light Client
A light client is a process that connects to the Tendermint Full Node(s) and then tries to verify the Merkle proofs A light client is a process that connects to the Tendermint Full Node(s) and then tries to verify the Merkle proofs
about the blockchain application. In this document we describe mechanisms that ensures that the Tendermint light client about the blockchain application. In this document we describe mechanisms that ensures that the Tendermint light client

2
docs/spec/p2p/node.md
View File

@ -1,4 +1,4 @@
# Tendermint Peer Discovery # Peer Discovery
A Tendermint P2P network has different kinds of nodes with different requirements for connectivity to one another. A Tendermint P2P network has different kinds of nodes with different requirements for connectivity to one another.
This document describes what kind of nodes Tendermint should enable and how they should work. This document describes what kind of nodes Tendermint should enable and how they should work.

2
docs/spec/p2p/peer.md
View File

@ -1,4 +1,4 @@
# Tendermint Peers # Peers
This document explains how Tendermint Peers are identified and how they connect to one another. This document explains how Tendermint Peers are identified and how they connect to one another.