Git Product home page Git Product logo

docs's Introduction

Website

This website is built using Docusaurus 2, a modern static website generator.

Contributing to Uniswap Docs

Contributing to the docs site is a great way to get involved in the dev community and help other devs along the way! Check out our guidelines here.

How to generate markdown files from solidity Natspec comments

Install solidity doc gen npm install solidity-docgen

Get the correct compiler version npm install -D solc-0.7@npm:[email protected]

Put the updated template contract.hbs in a /templates folder under the same directory as /contracts that you want to generate

Run npx solidity-docgen --solc-module solc-0.7 -t ./templates

How to gernerate markdown files from typescript commments

npm install --save-dev typedoc typedoc-plugin-markdown

typedoc --out <docs> src/index.ts

see https://www.npmjs.com/package/typedoc-plugin-markdown for details

How to Update search indices with algolia

create .env file with APPLICATION_ID and the API_KEY (write access) Edit config.json file with

  • start url from updated website
  • sitemap url from updated website: ex) for docs: https://docs.uniswap.org/sitemap.xml
  • "v3-docs" index name
  • install jq : brew install jq run docker run -it --env-file=.env -e "CONFIG=$(cat ./config.json | jq -r tostring)" algolia/docsearch-scraper

How to add a new page

Create a markdown file in its respective versioned docs, or versioned SDK, directory.

Installation

yarn install

Local Development

yarn run start

This command starts a local development server and open up a browser window. Most changes are reflected live without having to restart the server.

Clear cache

yarn docusaurus clear

Build

yarn build

This command generates static content into the build directory and can be served using any static contents hosting service.

Deployment

GIT_USER=<Your GitHub username> USE_SSH=true yarn deploy

If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the gh-pages branch.

docs's People

Contributors

ben-29 avatar bradens avatar callil avatar danrobinson avatar electrone901 avatar eltonite avatar eulerbeat5 avatar ewilz avatar ianlapham avatar jfrankfurt avatar julianmrodri avatar kamaci avatar kristiehuang avatar moodysalem avatar mrossesf avatar nathanhleung avatar nhausman1 avatar noahzinsmeister avatar pablocastellano avatar rachel-eichenberger avatar romainhuet avatar sandianyu avatar scbuergel avatar snreynolds avatar themaxdavitt avatar uniyj avatar willhennessy avatar willpote avatar yorkemartin avatar zhongeric avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.