Skip to content

Commit 51a0c4e

Browse files
committed
Initial commit
0 parents  commit 51a0c4e

18 files changed

+10612
-0
lines changed

.gitignore

+20
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*

README.md

+33
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
# Website
2+
3+
This website is built using [Docusaurus 2](https://v2.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 open 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+
```
30+
$ GIT_USER=<Your GitHub username> USE_SSH=true yarn deploy
31+
```
32+
33+
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.

docs/doc1.md

+200
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,200 @@
1+
---
2+
id: doc1
3+
title: Style Guide
4+
sidebar_label: Style Guide
5+
---
6+
7+
You can write content using [GitHub-flavored Markdown syntax](https://github.github.com/gfm/).
8+
9+
## Markdown Syntax
10+
11+
To serve as an example page when styling markdown based Docusaurus sites.
12+
13+
## Headers
14+
15+
# H1 - Create the best documentation
16+
17+
## H2 - Create the best documentation
18+
19+
### H3 - Create the best documentation
20+
21+
#### H4 - Create the best documentation
22+
23+
##### H5 - Create the best documentation
24+
25+
###### H6 - Create the best documentation
26+
27+
---
28+
29+
## Emphasis
30+
31+
Emphasis, aka italics, with *asterisks* or _underscores_.
32+
33+
Strong emphasis, aka bold, with **asterisks** or __underscores__.
34+
35+
Combined emphasis with **asterisks and _underscores_**.
36+
37+
Strikethrough uses two tildes. ~~Scratch this.~~
38+
39+
---
40+
41+
## Lists
42+
43+
1. First ordered list item
44+
1. Another item
45+
- Unordered sub-list.
46+
1. Actual numbers don't matter, just that it's a number
47+
1. Ordered sub-list
48+
1. And another item.
49+
50+
* Unordered list can use asterisks
51+
52+
- Or minuses
53+
54+
+ Or pluses
55+
56+
---
57+
58+
## Links
59+
60+
[I'm an inline-style link](https://www.google.com/)
61+
62+
[I'm an inline-style link with title](https://www.google.com/ "Google's Homepage")
63+
64+
[I'm a reference-style link][arbitrary case-insensitive reference text]
65+
66+
[I'm a relative reference to a repository file](../blob/master/LICENSE)
67+
68+
[You can use numbers for reference-style link definitions][1]
69+
70+
Or leave it empty and use the [link text itself].
71+
72+
URLs and URLs in angle brackets will automatically get turned into links. http://www.example.com/ or <http://www.example.com/> and sometimes example.com (but not on GitHub, for example).
73+
74+
Some text to show that the reference links can follow later.
75+
76+
[arbitrary case-insensitive reference text]: https://www.mozilla.org/
77+
[1]: http://slashdot.org/
78+
[link text itself]: http://www.reddit.com/
79+
80+
---
81+
82+
## Images
83+
84+
Here's our logo (hover to see the title text):
85+
86+
Inline-style: ![alt text](https://github.com/adam-p/markdown-here/raw/master/src/common/images/icon48.png 'Logo Title Text 1')
87+
88+
Reference-style: ![alt text][logo]
89+
90+
[logo]: https://github.com/adam-p/markdown-here/raw/master/src/common/images/icon48.png 'Logo Title Text 2'
91+
92+
---
93+
94+
## Code
95+
96+
```javascript
97+
var s = 'JavaScript syntax highlighting';
98+
alert(s);
99+
```
100+
101+
```python
102+
s = "Python syntax highlighting"
103+
print(s)
104+
```
105+
106+
```
107+
No language indicated, so no syntax highlighting.
108+
But let's throw in a <b>tag</b>.
109+
```
110+
111+
```js {2}
112+
function highlightMe() {
113+
console.log('This line can be highlighted!');
114+
}
115+
```
116+
117+
---
118+
119+
## Tables
120+
121+
Colons can be used to align columns.
122+
123+
| Tables | Are | Cool |
124+
| ------------- | :-----------: | -----: |
125+
| col 3 is | right-aligned | \$1600 |
126+
| col 2 is | centered | \$12 |
127+
| zebra stripes | are neat | \$1 |
128+
129+
There must be at least 3 dashes separating each header cell. The outer pipes (|) are optional, and you don't need to make the raw Markdown line up prettily. You can also use inline Markdown.
130+
131+
| Markdown | Less | Pretty |
132+
| -------- | --------- | ---------- |
133+
| _Still_ | `renders` | **nicely** |
134+
| 1 | 2 | 3 |
135+
136+
---
137+
138+
## Blockquotes
139+
140+
> Blockquotes are very handy in email to emulate reply text. This line is part of the same quote.
141+
142+
Quote break.
143+
144+
> This is a very long line that will still be quoted properly when it wraps. Oh boy let's keep writing to make sure this is long enough to actually wrap for everyone. Oh, you can _put_ **Markdown** into a blockquote.
145+
146+
---
147+
148+
## Inline HTML
149+
150+
<dl>
151+
<dt>Definition list</dt>
152+
<dd>Is something people use sometimes.</dd>
153+
154+
<dt>Markdown in HTML</dt>
155+
<dd>Does *not* work **very** well. Use HTML <em>tags</em>.</dd>
156+
</dl>
157+
158+
---
159+
160+
## Line Breaks
161+
162+
Here's a line for us to start with.
163+
164+
This line is separated from the one above by two newlines, so it will be a _separate paragraph_.
165+
166+
This line is also a separate paragraph, but... This line is only separated by a single newline, so it's a separate line in the _same paragraph_.
167+
168+
---
169+
170+
## Admonitions
171+
172+
:::note
173+
174+
This is a note
175+
176+
:::
177+
178+
:::tip
179+
180+
This is a tip
181+
182+
:::
183+
184+
:::important
185+
186+
This is important
187+
188+
:::
189+
190+
:::caution
191+
192+
This is a caution
193+
194+
:::
195+
196+
:::warning
197+
198+
This is a warning
199+
200+
:::

docs/doc2.md

+6
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
---
2+
id: doc2
3+
title: Document Number 2
4+
---
5+
6+
This is a link to [another document.](doc3.md) This is a link to an [external page.](http://www.example.com/)

docs/doc3.md

+14
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
---
2+
id: doc3
3+
title: This is Document Number 3
4+
---
5+
6+
Lorem ipsum dolor sit amet, consectetur adipiscing elit. In ac euismod odio, eu consequat dui. Nullam molestie consectetur risus id imperdiet. Proin sodales ornare turpis, non mollis massa ultricies id. Nam at nibh scelerisque, feugiat ante non, dapibus tortor. Vivamus volutpat diam quis tellus elementum bibendum. Praesent semper gravida velit quis aliquam. Etiam in cursus neque. Nam lectus ligula, malesuada et mauris a, bibendum faucibus mi. Phasellus ut interdum felis. Phasellus in odio pulvinar, porttitor urna eget, fringilla lectus. Aliquam sollicitudin est eros. Mauris consectetur quam vitae mauris interdum hendrerit. Lorem ipsum dolor sit amet, consectetur adipiscing elit.
7+
8+
Duis et egestas libero, imperdiet faucibus ipsum. Sed posuere eget urna vel feugiat. Vivamus a arcu sagittis, fermentum urna dapibus, congue lectus. Fusce vulputate porttitor nisl, ac cursus elit volutpat vitae. Nullam vitae ipsum egestas, convallis quam non, porta nibh. Morbi gravida erat nec neque bibendum, eu pellentesque velit posuere. Fusce aliquam erat eu massa eleifend tristique.
9+
10+
Sed consequat sollicitudin ipsum eget tempus. Integer a aliquet velit. In justo nibh, pellentesque non suscipit eget, gravida vel lacus. Donec odio ante, malesuada in massa quis, pharetra tristique ligula. Donec eros est, tristique eget finibus quis, semper non nisl. Vivamus et elit nec enim ornare placerat. Sed posuere odio a elit cursus sagittis.
11+
12+
Phasellus feugiat purus eu tortor ultrices finibus. Ut libero nibh, lobortis et libero nec, dapibus posuere eros. Sed sagittis euismod justo at consectetur. Nulla finibus libero placerat, cursus sapien at, eleifend ligula. Vivamus elit nisl, hendrerit ac nibh eu, ultrices tempus dui. Nam tellus neque, commodo non rhoncus eu, gravida in risus. Nullam id iaculis tortor.
13+
14+
Nullam at odio in sem varius tempor sit amet vel lorem. Etiam eu hendrerit nisl. Fusce nibh mauris, vulputate sit amet ex vitae, congue rhoncus nisl. Sed eget tellus purus. Nullam tempus commodo erat ut tristique. Cras accumsan massa sit amet justo consequat eleifend. Integer scelerisque vitae tellus id consectetur.

docs/mdx.md

+17
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
---
2+
id: mdx
3+
title: Powered by MDX
4+
---
5+
6+
You can write JSX and use React components within your Markdown thanks to [MDX](https://mdxjs.com/).
7+
8+
export const Highlight = ({children, color}) => ( <span style={{
9+
backgroundColor: color,
10+
borderRadius: '2px',
11+
color: '#fff',
12+
padding: '0.2rem',
13+
}}>{children}</span> );
14+
15+
<Highlight color="#25c2a0">Docusaurus green</Highlight> and <Highlight color="#1877F2">Facebook blue</Highlight> are my favorite colors.
16+
17+
I can write **Markdown** alongside my _JSX_!

docusaurus.config.js

+98
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,98 @@
1+
module.exports = {
2+
title: 'Plausible docs',
3+
tagline: 'The tagline of my site',
4+
url: 'https://docs.plausible.io',
5+
baseUrl: '/',
6+
favicon: 'img/favicon.ico',
7+
organizationName: 'plausible', // Usually your GitHub org/user name.
8+
projectName: 'analytics', // Usually your repo name.
9+
themeConfig: {
10+
navbar: {
11+
title: 'Plausible docs',
12+
logo: {
13+
alt: 'My Site Logo',
14+
src: 'img/logo.svg',
15+
},
16+
links: [
17+
{
18+
to: 'docs/',
19+
activeBasePath: 'docs',
20+
label: 'Docs',
21+
position: 'left',
22+
},
23+
{
24+
href: 'https://github.com/facebook/docusaurus',
25+
label: 'GitHub',
26+
position: 'right',
27+
},
28+
],
29+
},
30+
footer: {
31+
style: 'dark',
32+
links: [
33+
{
34+
title: 'Docs',
35+
items: [
36+
{
37+
label: 'Style Guide',
38+
to: 'docs/',
39+
},
40+
{
41+
label: 'Second Doc',
42+
to: 'docs/doc2/',
43+
},
44+
],
45+
},
46+
{
47+
title: 'Community',
48+
items: [
49+
{
50+
label: 'Stack Overflow',
51+
href: 'https://stackoverflow.com/questions/tagged/docusaurus',
52+
},
53+
{
54+
label: 'Discord',
55+
href: 'https://discordapp.com/invite/docusaurus',
56+
},
57+
{
58+
label: 'Twitter',
59+
href: 'https://twitter.com/docusaurus',
60+
},
61+
],
62+
},
63+
{
64+
title: 'More',
65+
items: [
66+
{
67+
label: 'Blog',
68+
to: 'blog',
69+
},
70+
{
71+
label: 'GitHub',
72+
href: 'https://github.com/facebook/docusaurus',
73+
},
74+
],
75+
},
76+
],
77+
copyright: `Copyright © ${new Date().getFullYear()} My Project, Inc. Built with Docusaurus.`,
78+
},
79+
},
80+
presets: [
81+
[
82+
'@docusaurus/preset-classic',
83+
{
84+
docs: {
85+
routeBasePath: '/', // Set this value to '/'.
86+
homePageId: 'doc1',
87+
sidebarPath: require.resolve('./sidebars.js'),
88+
// Please change this to your repo.
89+
editUrl:
90+
'https://github.com/facebook/docusaurus/edit/master/website/',
91+
},
92+
theme: {
93+
customCss: require.resolve('./src/css/custom.css'),
94+
},
95+
},
96+
],
97+
],
98+
};

0 commit comments

Comments
 (0)