90 lines
2.4 KiB
Plaintext
90 lines
2.4 KiB
Plaintext
---
|
|
title: Website & Docs
|
|
description: Information about the Jan website and documentation.
|
|
keywords:
|
|
[
|
|
Jan,
|
|
Customizable Intelligence, LLM,
|
|
local AI,
|
|
privacy focus,
|
|
free and open source,
|
|
private and offline,
|
|
conversational AI,
|
|
no-subscription fee,
|
|
large language models,
|
|
website,
|
|
documentation,
|
|
]
|
|
---
|
|
|
|
# Website & Docs
|
|
|
|
This website is built using [Docusaurus 3.0](https://docusaurus.io/), a modern static website generator.
|
|
|
|
## Information Architecture
|
|
|
|
We try to **keep routes consistent** to maintain SEO.
|
|
|
|
- **`/guides/`**: Guides on how to use the Jan application. For end users who are directly using Jan.
|
|
|
|
- **`/developer/`**: Developer docs on how to extend Jan. These pages are about what people can build with our software.
|
|
|
|
- **`/api-reference/`**: Reference documentation for the Jan API server, written in Swagger/OpenAPI format.
|
|
|
|
- **`/changelog/`**: A list of changes made to the Jan application with each release.
|
|
|
|
- **`/blog/`**: A blog for the Jan application.
|
|
|
|
## How to Contribute
|
|
|
|
Refer to the [Contributing Guide](https://github.com/menloresearch/jan/blob/dev/CONTRIBUTING.md) for more comprehensive information on how to contribute to the Jan project.
|
|
|
|
## Pre-requisites and Installation
|
|
|
|
- [Node.js](https://nodejs.org/en/) (version 20.0.0 or higher)
|
|
- [yarn](https://yarnpkg.com/) (version 1.22.0 or higher)
|
|
|
|
### Installation
|
|
|
|
```bash
|
|
cd jan/docs
|
|
```
|
|
|
|
```bash
|
|
yarn install && yarn start
|
|
```
|
|
|
|
This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
|
|
|
|
### Build
|
|
|
|
```bash
|
|
yarn build
|
|
```
|
|
|
|
This command generates static content into the `build` directory and can be served using any static contents hosting service.
|
|
|
|
### Deployment
|
|
|
|
Using SSH:
|
|
|
|
```bash
|
|
USE_SSH=true yarn deploy
|
|
```
|
|
|
|
Not using SSH:
|
|
|
|
```bash
|
|
GIT_USER=<Your GitHub username> 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.
|
|
|
|
### Preview URL, Pre-release and Publishing Documentation
|
|
|
|
- When a pull request is created, the preview URL will be automatically commented on the pull request.
|
|
|
|
- The documentation will then be published to [https://dev.jan.ai/](https://dev.jan.ai/) when the pull request is merged to `main`.
|
|
|
|
- Our open-source maintainers will sync the updated content from `main` to `release` branch, which will then be published to [https://jan.ai/](https://jan.ai/).
|