Paul Wackerow
405822a262
|
2 years ago | |
---|---|---|
docs | 2 years ago | |
public | 2 years ago | |
src | 2 years ago | |
.env.local.example | 2 years ago | |
.eslintignore | 2 years ago | |
.eslintrc.json | 2 years ago | |
.gitignore | 2 years ago | |
.prettierignore | 2 years ago | |
.prettierrc | 2 years ago | |
README.md | 2 years ago | |
netlify.toml | 2 years ago | |
next-sitemap.config.js | 2 years ago | |
next.config.js | 2 years ago | |
package.json | 2 years ago | |
redirects.js | 2 years ago | |
tsconfig.json | 2 years ago | |
url-list.csv | 2 years ago | |
yarn.lock | 2 years ago |
README.md
Welcome to the go-ethereum website!
This is the repository for the go-ethereum
website. All the website code is held here in the website
branch. If you are looking for go-ethereum
source code you need to switch to the master
branch.
The purpose of the go-ethereum website is to provide the necessary documentation and supporting information to help users to get up to speed with using go-ethereum (aka "Geth"). The website is maintained by a team of developers but community contributions are also very welcome.
Contributing
Contributions from the community are very welcome. Please contribute by cloning the go-ethereum
repository, checking out the website
branch and raising pull requests to be reviewed and merged by the repository maintainers. Issues can be raised in the main go-ethereum
repository using the prefix [website]:
in the title.
The geth.ethereum.org stack
geth.ethereum.org is a Next.js project bootstrapped with create-next-app
. The following tools were used to build the site:
- Node.js
- Yarn package manager
- React - A JavaScript library for building component-based user interfaces
- Typescript - TypeScript is a strongly typed programming language that builds on JavaScript
- Chakra UI - A UI library (Migration in progress)
- Algolia - Site indexing, rapid intra-site search results, and search analytics. Learn more on how we implement Algolia for site search.
- Primary implementation:
/src/components/Search/index.ts
- Primary implementation:
- Netlify - DNS management and primary host for
master
build.
Repository structure
The website code is organized with a top-level docs
folder that contains all the documentation pages as markdown files. Inside docs
are subdirectories used to divide the docs by theme (e.g. getting-started
,fundamentals
, developers
etc). Website code is in src
, and assets including images are in public
.
Adding a new documentation page
Documentation pages are located in the /docs
folder in the root directory of the project. The docs pages are all markdown files. When you want to add a new page, add the new file in the appropriate folder in the /docs
page. index.md
files will be the default page for a directory, and {pagename}.md
will define subpages for a directory.
Notes in documentation pages are highlighted in pale blue boxes. To add a note, wrap the note text in <Note>
tage as follows:
<Note> text to include in note</Note>
Images should be saved to public/images/docs
and included in the markdown as follows:
![alt-text](/images/docs/image-title.png)
After adding a page, you will also need to list it in /src/data/documentation-links.yaml
. This file defines the documentation structure which you will see on the left sidebar in the documentation pages.
Building locally
To check a new page it is helpful to build the site locally and see how it behaves in the browser. First, run the development server:
npm run dev
# or
yarn dev
Open http://localhost:3000 with your browser to see the result.
You can start editing the page by modifying pages/index.tsx
. The page auto-updates as you edit the file.
Review and merge
PRs will be reviewed by the website maintainers and merged if they improve the website. For substantial changes it is best to reach out to the team by raising a GH issue for discussion first.