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.

You're going to need:

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

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

npm
npm run docs:dev

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

1. Create a markdown file under /docs/getting-started/
2. Open /docs/.vuepress/config.js
3. 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]
          ...,
        };
        ...
      }
    }
    ]
  ]
}

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.

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

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