Crypto.org Chain

Crypto.org Chain's documentation

The documentation in this repository site is meant to provide specifications and implementation details that will be useful to third party developers or contributors to the main repository.

Getting Started

Prerequisites

You're going to need:

NPM
Oracle JDK (For generating the pdf, deployment needs this)

Getting Set Up

Fork this repository on Github
Clone your forked repository (not our original one) to your hard drive with git clone https://github.com/YOURUSERNAME/chain-docs.git
cd chain-docs
Initialize and start chain-docs.

npm
npm run docs:dev

You can now see the docs at http://localhost:8080.

Adding new page to the doc

Create a markdown file under /docs/getting-started/
Open /docs/.vuepress/config.js
Add the file name to sidebar and the ordering under vuepress-plugin-export in plugins

module.exports = {
  ...,

  themeConfig: {
    ...,

    sidebar: {
      '/getting-started/': [
        '',
        ...,
+        '[Add_Your_New_File_Name_Here]'
        ...
      ]
    }
  },
  ...,

  plugins: [
    ['vuepress-plugin-export',
    {
      sorter: function(a,b){
        var ordering = {
          'Home': 0,
          ...,
+         '[Add_Your_New_File_Name_Here]': [Add_The_Number_You_Want_The_Page_Be_Ordered]
          ...,
        };
        ...
      }
    }
    ]
  ]
}

Generating a PDF version of the site

Go to chain-docs/docs, then run:

vuepress export

PDF styling config in /docs/.vuepress/config.js, you can refer to Puppeteer doc for the complete page API when generating PDF.

module.exports = {
  plugins: [
    ['vuepress-plugin-export',
    {
      page: {         // Puppeteer.page.pdf([options])
        format: 'A4',
        printBackground: true,
        margin: {
          top: 60,
          left: 20,
          right: 20,
          bottom: 60
        }
      },
      sorter: function(a,b){
        ...,
      }
    }
    ]
  ]
}

a PDF version of the site will be generated under the /docs path.

Deploying Chain-doc to Github Pages

Make sure you're working on a fork in your own account, not our original repository: git remote show origin
Commit your changes: git commit -a -m "YOUR MESSAGE"
Push the changes to GitHub: git push
Run ./deploy.sh

You should see your updates on http://yourusermame.github.io/chain-docs.

crypto-org-chain / chain-docs

readme