meshtastic/docs/developers/maintaining-documentation/serve-docs-locally.md

60 lines
1.3 KiB
Markdown
Raw Normal View History

2022-01-31 09:09:37 -08:00
---
id: serve-docs-locally
title: Setting up Local Documentation
sidebar_label: Serve Docs Locally
---
2022-03-08 23:51:46 -08:00
2022-01-31 09:09:37 -08:00
:::note
Some things won't display properly like logos or protobufs, this is not cause for concern.
:::
2022-03-08 23:51:46 -08:00
2022-01-31 09:09:37 -08:00
## Prerequisites
2022-03-08 23:51:46 -08:00
2022-01-31 09:09:37 -08:00
In order to set up your local environment, you will need to install:
- [Node & Node package manager (NPM)](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm)
- [Yarn package manager](https://yarnpkg.com/getting-started/install)
2022-02-08 05:33:51 -08:00
## Getting Started
2022-03-08 23:51:46 -08:00
2022-01-31 09:09:37 -08:00
### Fork the Meshtastic Repository
Log into Github and create a fork of the [meshtastic/Meshtastic](https://github.com/meshtastic/Meshtastic) repository.
### Clone your Meshtastic Repository fork
:::note
Replace `username` with your Github username.
:::
```bash title="Clone username/Meshtastic Repo"
git clone https://github.com/username/Meshtastic.git
```
### Change directory to Local copy
2022-03-08 23:51:46 -08:00
2022-01-31 09:09:37 -08:00
```bash title="Change Directory"
cd ~/Meshtastic
```
### Install Dependencies
2022-03-08 23:51:46 -08:00
2022-01-31 09:09:37 -08:00
```bash title="Install dependencies using Yarn"
yarn install
```
### Run Development Server
2022-03-08 23:51:46 -08:00
2022-01-31 09:09:37 -08:00
```bash title="Run node.js server"
yarn start
```
2022-02-08 05:33:51 -08:00
:::tip
Before submitting a pull request, it's helpful to run the following command to ensure there are no broken links or errors:
```bash title="Build Project"
yarn build
```
2022-03-08 23:51:46 -08:00
2022-02-08 05:33:51 -08:00
:::