Skip to content

Commit fd542a2

Browse files
committed
docs: add docusaurus assets
1 parent 8ee036a commit fd542a2

17 files changed

+18299
-0
lines changed

docs/.gitignore

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
# Dependencies
2+
/node_modules
3+
4+
# Production
5+
/build
6+
7+
# Generated files
8+
.docusaurus
9+
.cache-loader
10+
11+
# Misc
12+
.DS_Store
13+
.env.local
14+
.env.development.local
15+
.env.test.local
16+
.env.production.local
17+
18+
npm-debug.log*
19+
yarn-debug.log*
20+
yarn-error.log*

docs/README.md

Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,41 @@
1+
# Website
2+
3+
This website is built using [Docusaurus](https://docusaurus.io/), a modern static website generator.
4+
5+
### Installation
6+
7+
```
8+
$ yarn
9+
```
10+
11+
### Local Development
12+
13+
```
14+
$ yarn start
15+
```
16+
17+
This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
18+
19+
### Build
20+
21+
```
22+
$ yarn build
23+
```
24+
25+
This command generates static content into the `build` directory and can be served using any static contents hosting service.
26+
27+
### Deployment
28+
29+
Using SSH:
30+
31+
```
32+
$ USE_SSH=true yarn deploy
33+
```
34+
35+
Not using SSH:
36+
37+
```
38+
$ GIT_USER=<Your GitHub username> yarn deploy
39+
```
40+
41+
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.
File renamed without changes.

docs/docusaurus.config.ts

Lines changed: 73 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,73 @@
1+
import { themes as prismThemes } from 'prism-react-renderer';
2+
import type { Config } from '@docusaurus/types';
3+
import type * as Preset from '@docusaurus/preset-classic';
4+
5+
const config: Config = {
6+
title: 'BirdXplorer Documentation',
7+
tagline: 'BirdXplorer is software that helps users explore community notes data on X (formerly known as Twitter).',
8+
favicon: 'img/favicon.ico',
9+
10+
url: 'https://github.com/',
11+
baseUrl: '/codeforjapan/BirdXplorer/',
12+
13+
organizationName: 'codeforjapan',
14+
projectName: 'BirdXplorer',
15+
16+
onBrokenLinks: 'throw',
17+
onBrokenMarkdownLinks: 'warn',
18+
19+
i18n: {
20+
defaultLocale: 'en',
21+
locales: ['en', 'ja'],
22+
},
23+
24+
presets: [
25+
[
26+
'classic',
27+
{
28+
docs: {
29+
sidebarPath: './sidebars.ts',
30+
},
31+
theme: {
32+
customCss: './src/css/custom.css',
33+
},
34+
} satisfies Preset.Options,
35+
],
36+
],
37+
38+
themeConfig: {
39+
image: 'img/birdxplorer-social-card.jpg',
40+
navbar: {
41+
title: 'BirdXplorer Documentation',
42+
logo: {
43+
alt: 'BirdXplorer Logo',
44+
src: 'img/logo.png',
45+
},
46+
items: [
47+
{
48+
type: 'docSidebar',
49+
sidebarId: 'docsSidebar',
50+
position: 'left',
51+
label: 'Docs',
52+
},
53+
{
54+
href: 'https://github.com/codeforjapan/BirdXplorer',
55+
className: 'header-github-link',
56+
'aria-label': 'GitHub repository',
57+
position: 'right',
58+
label: 'GitHub',
59+
},
60+
],
61+
},
62+
footer: {
63+
style: 'dark',
64+
copyright: `Copyright © ${new Date().getFullYear()} Code for Japan. Built with Docusaurus.`,
65+
},
66+
prism: {
67+
theme: prismThemes.github,
68+
darkTheme: prismThemes.dracula,
69+
},
70+
} satisfies Preset.ThemeConfig,
71+
};
72+
73+
export default config;

0 commit comments

Comments
 (0)