Initial commit
This commit is contained in:
commit
720539cb7e
|
@ -0,0 +1,26 @@
|
||||||
|
# Dependencies
|
||||||
|
/node_modules
|
||||||
|
|
||||||
|
# Production
|
||||||
|
/build
|
||||||
|
|
||||||
|
# Generated files
|
||||||
|
.docusaurus
|
||||||
|
.cache-loader
|
||||||
|
|
||||||
|
# Misc
|
||||||
|
.DS_Store
|
||||||
|
.env
|
||||||
|
.env.local
|
||||||
|
.env.development.local
|
||||||
|
.env.test.local
|
||||||
|
.env.production.local
|
||||||
|
|
||||||
|
npm-debug.log*
|
||||||
|
yarn-debug.log*
|
||||||
|
yarn-error.log*
|
||||||
|
.yalc
|
||||||
|
yalc.lock
|
||||||
|
.idea
|
||||||
|
|
||||||
|
static/search-index.json
|
|
@ -0,0 +1,2 @@
|
||||||
|
#!/usr/bin/env sh
|
||||||
|
. "$(dirname -- "$0")/_/husky.sh"
|
|
@ -0,0 +1,5 @@
|
||||||
|
#!/usr/bin/env sh
|
||||||
|
. "$(dirname -- "$0")/_/husky.sh"
|
||||||
|
|
||||||
|
yarn prettier:staged
|
||||||
|
yarn typecheck
|
|
@ -0,0 +1,2 @@
|
||||||
|
*.mdx
|
||||||
|
*.md
|
|
@ -0,0 +1,6 @@
|
||||||
|
{
|
||||||
|
"tabWidth": 2,
|
||||||
|
"semi": false,
|
||||||
|
"singleQuote": true,
|
||||||
|
"trailingComma": "all"
|
||||||
|
}
|
|
@ -0,0 +1,46 @@
|
||||||
|
- [Description](#description)
|
||||||
|
- [How to Run Locally](#how-to-run-locally)
|
||||||
|
- [Configuration](#configuration)
|
||||||
|
- [Customization](#customization)
|
||||||
|
|
||||||
|
## Description
|
||||||
|
|
||||||
|
This repository contains the content of your documentation website.
|
||||||
|
|
||||||
|
## How to Run Locally
|
||||||
|
|
||||||
|
1. Clone this repository.
|
||||||
|
2. Install the dependencies:
|
||||||
|
```bash
|
||||||
|
$ yarn
|
||||||
|
```
|
||||||
|
3. Start and open the website in your browser:
|
||||||
|
```bash
|
||||||
|
$ yarn start
|
||||||
|
```
|
||||||
|
|
||||||
|
## Configuration
|
||||||
|
Edit the `docusaurus.config.js` file in the repository's root directory, and update the value of the `businessUnit` field in presets section; below is a list of valid values:
|
||||||
|
- Logos
|
||||||
|
- Codex
|
||||||
|
- Waku
|
||||||
|
|
||||||
|
Example:
|
||||||
|
```js
|
||||||
|
presets: [
|
||||||
|
[
|
||||||
|
'@acid-info/logos-docusaurus-preset',
|
||||||
|
{
|
||||||
|
businessUnit: 'Codex',
|
||||||
|
},
|
||||||
|
],
|
||||||
|
],
|
||||||
|
```
|
||||||
|
|
||||||
|
This is probably enough in most cases, as the Logos plugins will fill in other configurations related to the specified business unit. If you find any error in the information coming from Logos Plugins, please head over to [Logos Docusaurus Plugins](https://github.com/acid-info/logos-docusaurus-plugins) and create an issue.
|
||||||
|
|
||||||
|
## Customization
|
||||||
|
|
||||||
|
You can find the instructions on adding more documentation sections, localization, and versioning on the [Docusaurus](https://docusaurus.io/docs) website.
|
||||||
|
|
||||||
|
> Note that theme customization is limited; for further instructions on customizing your theme, head over to [Logos Docusaurus Theme](https://github.com/acid-info/logos-docusaurus-plugins/tree/main/packages/logos-docusaurus-theme/).
|
|
@ -0,0 +1,3 @@
|
||||||
|
module.exports = {
|
||||||
|
presets: [require.resolve("@docusaurus/core/lib/babel/preset")],
|
||||||
|
};
|
|
@ -0,0 +1,50 @@
|
||||||
|
---
|
||||||
|
title: Home
|
||||||
|
---
|
||||||
|
|
||||||
|
- [Description](#description)
|
||||||
|
- [How to Run Locally](#how-to-run-locally)
|
||||||
|
- [Configuration](#configuration)
|
||||||
|
- [Customization](#customization)
|
||||||
|
|
||||||
|
## Description
|
||||||
|
|
||||||
|
This repository contains the content of your documentation website.
|
||||||
|
|
||||||
|
## How to Run Locally
|
||||||
|
|
||||||
|
1. Clone this repository.
|
||||||
|
2. Install the dependencies:
|
||||||
|
```bash
|
||||||
|
$ yarn
|
||||||
|
```
|
||||||
|
3. Start and open the website in your browser:
|
||||||
|
```bash
|
||||||
|
$ yarn start
|
||||||
|
```
|
||||||
|
|
||||||
|
## Configuration
|
||||||
|
Edit the `docusaurus.config.js` file in the repository's root directory, and update the value of the `businessUnit` field in presets section; below is a list of valid values:
|
||||||
|
- Logos
|
||||||
|
- Codex
|
||||||
|
- Waku
|
||||||
|
|
||||||
|
Example:
|
||||||
|
```js
|
||||||
|
presets: [
|
||||||
|
[
|
||||||
|
'@acid-info/logos-docusaurus-preset',
|
||||||
|
{
|
||||||
|
businessUnit: 'Codex',
|
||||||
|
},
|
||||||
|
],
|
||||||
|
],
|
||||||
|
```
|
||||||
|
|
||||||
|
This is probably enough in most cases, as the Logos plugins will fill in other configurations related to the specified business unit. If you find any error in the information coming from Logos Plugins, please head over to [Logos Docusaurus Plugins](https://github.com/acid-info/logos-docusaurus-plugins) and create an issue.
|
||||||
|
|
||||||
|
## Customization
|
||||||
|
|
||||||
|
You can find the instructions on adding more documentation sections, localization, and versioning on the [Docusaurus](https://docusaurus.io/docs) website.
|
||||||
|
|
||||||
|
> Note that theme customization is limited; for further instructions on customizing your theme, head over to [Logos Docusaurus Theme](https://github.com/acid-info/logos-docusaurus-plugins/tree/main/packages/logos-docusaurus-theme/).
|
|
@ -0,0 +1,44 @@
|
||||||
|
// @ts-check
|
||||||
|
// Note: type annotations allow type checking and IDEs autocompletion
|
||||||
|
require('dotenv').config()
|
||||||
|
|
||||||
|
/** @type {import('@docusaurus/types').Config} */
|
||||||
|
const config = {
|
||||||
|
title: 'TITLE',
|
||||||
|
url: 'https://url',
|
||||||
|
baseUrl: '/',
|
||||||
|
|
||||||
|
customFields: {
|
||||||
|
ghostAPiKey: process.env.GHOST_API_KEY,
|
||||||
|
},
|
||||||
|
|
||||||
|
// Even if you don't use internalization, you can use this field to set useful
|
||||||
|
// metadata like html lang. For example, if your site is Chinese, you may want
|
||||||
|
// to replace "en" with "zh-Hans".
|
||||||
|
i18n: {
|
||||||
|
defaultLocale: 'en',
|
||||||
|
locales: ['en'],
|
||||||
|
},
|
||||||
|
|
||||||
|
presets: [
|
||||||
|
[
|
||||||
|
'@acid-info/logos-docusaurus-preset',
|
||||||
|
/** @type {import('@acid-info/logos-docusaurus-preset').PluginOptions} */
|
||||||
|
({
|
||||||
|
businessUnit: 'Logos',
|
||||||
|
theme: {
|
||||||
|
name: 'default',
|
||||||
|
options: {
|
||||||
|
customCss: [require.resolve('./src/css/custom.scss')],
|
||||||
|
},
|
||||||
|
},
|
||||||
|
}),
|
||||||
|
],
|
||||||
|
],
|
||||||
|
|
||||||
|
themeConfig:
|
||||||
|
/** @type {import('@acid-info/logos-docusaurus-preset').ThemeConfig} */
|
||||||
|
({}),
|
||||||
|
}
|
||||||
|
|
||||||
|
module.exports = config
|
|
@ -0,0 +1,55 @@
|
||||||
|
{
|
||||||
|
"name": "logos-documentation-website-template",
|
||||||
|
"version": "0.0.0",
|
||||||
|
"private": true,
|
||||||
|
"scripts": {
|
||||||
|
"docusaurus": "docusaurus",
|
||||||
|
"start": "docusaurus start",
|
||||||
|
"build": "docusaurus build",
|
||||||
|
"swizzle": "docusaurus swizzle",
|
||||||
|
"deploy": "docusaurus deploy",
|
||||||
|
"clear": "docusaurus clear",
|
||||||
|
"serve": "docusaurus serve",
|
||||||
|
"write-translations": "docusaurus write-translations",
|
||||||
|
"write-heading-ids": "docusaurus write-heading-ids",
|
||||||
|
"typecheck": "tsc",
|
||||||
|
"prepare": "husky install",
|
||||||
|
"prettier": "pretty-quick",
|
||||||
|
"prettier:staged": "pretty-quick --staged"
|
||||||
|
},
|
||||||
|
"dependencies": {
|
||||||
|
"@acid-info/logos-docusaurus-preset": "^0.1.7",
|
||||||
|
"@docusaurus/core": "2.1.0",
|
||||||
|
"@docusaurus/preset-classic": "2.1.0",
|
||||||
|
"@mdx-js/react": "^1.6.22",
|
||||||
|
"dotenv": "^16.0.3",
|
||||||
|
"prism-react-renderer": "^1.3.5",
|
||||||
|
"react": "^17.0.2",
|
||||||
|
"react-dom": "^17.0.2"
|
||||||
|
},
|
||||||
|
"devDependencies": {
|
||||||
|
"@docusaurus/module-type-aliases": "2.1.0",
|
||||||
|
"@tsconfig/docusaurus": "^1.0.5",
|
||||||
|
"docusaurus-plugin-sass": "^0.2.2",
|
||||||
|
"husky": "^8.0.1",
|
||||||
|
"prettier": "^2.7.1",
|
||||||
|
"pretty-quick": "^3.1.3",
|
||||||
|
"sass": "^1.55.0",
|
||||||
|
"typescript": "^4.7.4"
|
||||||
|
},
|
||||||
|
"browserslist": {
|
||||||
|
"production": [
|
||||||
|
">0.5%",
|
||||||
|
"not dead",
|
||||||
|
"not op_mini all"
|
||||||
|
],
|
||||||
|
"development": [
|
||||||
|
"last 1 chrome version",
|
||||||
|
"last 1 firefox version",
|
||||||
|
"last 1 safari version"
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">=16.14"
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,33 @@
|
||||||
|
/**
|
||||||
|
* Creating a sidebar enables you to:
|
||||||
|
- create an ordered group of docs
|
||||||
|
- render a sidebar for each doc of that group
|
||||||
|
- provide next/previous navigation
|
||||||
|
|
||||||
|
The sidebars can be generated from the filesystem, or explicitly defined here.
|
||||||
|
|
||||||
|
Create as many sidebars as you want.
|
||||||
|
*/
|
||||||
|
|
||||||
|
// @ts-check
|
||||||
|
|
||||||
|
/** @type {import('@docusaurus/plugin-content-docs').SidebarsConfig} */
|
||||||
|
const sidebars = {
|
||||||
|
// By default, Docusaurus generates a sidebar from the docs folder structure
|
||||||
|
tutorialSidebar: [{ type: 'autogenerated', dirName: '.' }],
|
||||||
|
|
||||||
|
// But you can create a sidebar manually
|
||||||
|
/*
|
||||||
|
tutorialSidebar: [
|
||||||
|
'intro',
|
||||||
|
'hello',
|
||||||
|
{
|
||||||
|
type: 'category',
|
||||||
|
label: 'Tutorial',
|
||||||
|
items: ['tutorial-basics/create-a-document'],
|
||||||
|
},
|
||||||
|
],
|
||||||
|
*/
|
||||||
|
}
|
||||||
|
|
||||||
|
module.exports = sidebars
|
|
@ -0,0 +1 @@
|
||||||
|
export * from '@acid-info/logos-docusaurus-theme/lib/client/components/mdx'
|
|
@ -0,0 +1,2 @@
|
||||||
|
:root {
|
||||||
|
}
|
|
@ -0,0 +1,4 @@
|
||||||
|
{
|
||||||
|
// This file is not used in compilation. It is here just for a nice editor experience.
|
||||||
|
"extends": "@tsconfig/docusaurus/tsconfig.json"
|
||||||
|
}
|
Loading…
Reference in New Issue