Commit graph

275 commits

Author SHA1 Message Date
Leo Lamprecht
f1a504e813 docs: suggest ZEIT Now for quick deployment of 2.0 (#1691)
* Suggest quick deployments for Docusaurus 2.0

* Sub heading

* Sub heading

* Sub heading

* Sub heading

* Update getting-started-publishing.md

* Update getting-started-publishing.md

* Update getting-started-publishing.md

* Update getting-started-publishing.md

* Update deployment.md

* Added to auto-deploy section

* Added to auto-deploy section

* Added to auto-deploy section

* Added to auto-deploy section

* Mention Git integration

* Update deployment.md

* Update deployment.md
2019-07-22 13:55:00 -07:00
Leo Lamprecht
96a970e5bf docs: suggest ZEIT Now for quick deployment (#1690)
* Suggest ZEIT Now for quick deployment

* Simpler heading

* Added 1.10.x

* Added 1.12.0

* Adedd 1.9.x
2019-07-22 10:55:53 -07:00
Anurag Goel
ee2050d612 docs: add Render hosting guide (#1615)
* Add Render deployment guide

* Add guide for Docusaurus 2

* Update guide for v2
2019-07-12 09:58:23 -07:00
Danny Hurlburt
684a2461bd docs: Fix Rendering of <AUTOGENERATED_TABLE_OF_CONTENTS> Tag on API - Markdown Features Page (#1617) 2019-07-12 23:32:52 +08:00
Danny Hurlburt
6dbada2f08 docs: minor grammar fix in blog guide (#1614) 2019-06-19 10:49:38 -07:00
Danny Hurlburt
8ea6e5688f docs: fix reference to publishing steps (#1613) 2019-06-17 11:15:32 -07:00
Yangshun Tay
49cfdeb42b feat: make blog posts unlisted only in production 2019-06-15 10:32:43 -07:00
Joel Marcey
b2fe2a65c8 docs: add more clarity about markdown fields (#1589)
I wanted to enable superscript and subscripting to a v1 site. It wasn't quite clear how to do it. @yangshun helped me figure it out. So I thought I would document it.
2019-06-07 12:55:24 -07:00
Kent Williams
90138d52c2 docs: fix typo in guides-blog.md (#1553) 2019-06-03 18:30:22 -07:00
orangehat
fa4d72d969 docs: clean up language in create new site tutorial (#1537)
* Clean up tutorial language

Minor changes to clarify wording and grammar.

* Update tutorial-create-new-site.md
2019-05-31 08:47:05 -07:00
orangehat
43ff2b7670 docs: clarify wording/grammar for create pages tutorial (#1536)
* Clarify wording/grammar for tutorial

* Update tutorial-create-pages.md
2019-05-31 08:36:59 -07:00
SADIK KUZU
1282df063c docs: fix typo in website/pages folder structure (#1506) 2019-05-23 09:21:46 -07:00
Cole
0568ad4992 feat: allow different host through CLI flag (#1475)
* feat(core): use 0.0.0.0 for livereload address

* test(core): update server tests

* feat(cli): add host by command line flag

* test: revert test changes

* fix(core): update server to use custom host if supplied

* refactor: nits
2019-05-20 23:31:41 +07:00
Hongarc
f18e07343c docs: fix typo for docs folder (#1484)
* docs: fix typo for `docs` folder

* docs: request change for #1484

* Update api-doc-markdown.md
2019-05-17 10:26:55 -07:00
TurekBot
be149e182f docs: clarify location of sidebars.json (#1472)
In #1468 we clarify where the `docs` folder is. 
Here, we make it clear where `sidebars.json` is.
2019-05-16 19:29:02 -07:00
Hongarc
54a00e7a04 docs: normalized spelling of web server (#1473) 2019-05-16 19:28:22 -07:00
TurekBot
cb7c6f34b9 doc: mention HTTPS approach in tutorial git clone step (#1471)
* doc: change tutorial git to suggest HTTPS

Since we're instructing the user to create a new repository, it might be a safe bet to assume that they don't have their SSH keys set up. HTTPS might be a better option in this context.

* docs: keep ssh add https

@Hongarc said, "How about keep `SSH` and add `HTTPS`." This is one way to do that.

* Update tutorial-setup.md
2019-05-16 19:20:27 -07:00
TurekBot
a7b19c083a docs: add hint for linking dependencies time (#1470)
In this tutorial we assume that the user may or may not have used Node.js. It would follow then, based on how long it takes the "Linking dependencies" step to complete—243.61s for me—that we give them a hint that it might take a minute.
2019-05-16 19:17:47 -07:00
TurekBot
2a48b83ff2 docs: make it clear in the tutorial where the docs folder is (#1468)
* Make it clear where the `docs` folder is

It was not clear, to the beginner user—who this tutorial is for—where the `docs` folder was . The only reason I know this is because I'm a beginner user and I tried for too many minutes to find the `docs` folder inside the `website` folder. I had this assumption because the previous example is offered under the assumption that you're in the `website` folder.

Feel free to change the wording, I just want to make it clear where you should be looking, if you're new.

* Update tutorial-create-pages.md
2019-05-16 16:03:59 -07:00
Yangshun Tay
c84860d9fa
doc: remove references to F8 in tutorial (#1432)
* doc: remove references to F8 in tutorial

* misc: use correct bold syntax

* misc: fix path
2019-05-02 19:16:05 -07:00
Yangshun Tay
64fdafbcea fix: replace use of deepmerge with _.merge (#1430) 2019-05-02 22:00:28 +07:00
Yangshun Tay
2fe73edc22
docs: add versioning to tutorial (#1413)
* docs: add versioning to tutorial

* docs: address Endilie's comments
2019-04-29 09:51:42 -07:00
Yangshun Tay
ecf1f9a2c4 docs: remove example mentions 2019-04-27 22:01:09 -07:00
Wilson Mar
9426b033ee docs-examples-from-docusaurus is now installed as doc (#1406)
docs: docs-examples-from-docusaurus is now installed as doc
2019-04-27 21:09:09 -07:00
Juan Picado @jotadeveloper
7ebcf10478 fix: blog docs example as object property (#1403) 2019-04-27 09:45:43 -07:00
Yangshun Tay
16fe5196cb fix: use class names for tutorial images 2019-04-23 11:36:51 -07:00
Yangshun Tay
23e56f61f5
feat: add tutorial (#1381)
* feat: add tutorial

* feat: complete tutorial

* Fix link
2019-04-23 09:44:37 -07:00
Yangshun Tay
21793a833d
feat: docusaurus-init without example directories (#1378)
* feat: do not copy into examples folder

* Update documentation

* feat: use Undraw illustrations for initialized landing page (#1379)
2019-04-21 22:28:35 -07:00
pkowaluk
866f66241b docs: change parameter type for separateCss from string to array (#1358) 2019-04-12 00:56:06 -07:00
Parth Patel
d279836c40 feat: Add --skip-next-release option to yarn build (#1292) 2019-03-29 16:17:46 +07:00
Yangshun Tay
edec1a9eda misc: s/Circle CI/CircleCI 2019-03-26 23:16:34 -07:00
Yangshun Tay
431510e9ab fix: broken links due to monorepo migration 2019-03-26 22:03:53 -07:00
Endilie Yacop Sucipto
643addb729
feat(v2): enable JSX in markdown using MDX (#1263)
* feat(v2): enable JSX in markdown

* reformat docs

* chore(v2): nits

* remove dummy test

* include .mdx extension

* add syntax highlighting with prismjs
2019-03-08 01:02:47 +08:00
Adel El Masery
48f95219a8 docs: update api-pages.md to document about overriding default styles (#1266)
docs: update api-pages.md to document about overriding default styles
2019-03-06 13:41:02 -08:00
Yangshun Tay
f559b1dc7c refactor(v2): move website dir out of v2 for cleaner separations 2019-02-24 14:13:08 -08:00
Yangshun Tay
1efaabc158
docs: mention about CNAME option in publishing docs (#1227)
* docs: mention about CNAME option in publishing docs

* Update getting-started-publishing.md
2019-02-08 21:15:59 +08:00
Yangshun Tay
dcd3361413 misc: update docs for new features 2019-01-23 23:20:11 -08:00
Fienny Angelina
5ce85e5b5e feat: code block tab (#1063)
* Try to find a way to recognize the codeblock tabs, its title, and
where it ends
- I try using DOCUSAURUS_CODE_TABS to mark the start
- Use TAB_TITLE to mark the title of the tab
- END_TAB to mark the end of that tab
- END_DOCUSAURUS_CODE_TABS to mark the end of the whole code blocks
then parse using regex and render accordingly

* Added on click hook

* Added example on how to write it, how to use it, how it will look like can be reverted later

* Fix css error

* - Move addEventListener part to lib/static
- Remove comments

* Add documentation

* Remove examples

* Change syntax of the codetabs
2019-01-23 21:48:01 -08:00
tsmrachel
d5fd15ecbe feat: collapsible categories (#1128)
* feat : #1084 Collapsus - The Collapsible Menu

* updated docs

* fixed prettier

* fix for category not auto-expanding upon navigating to a subcategory under it

* as requested by endiliey. Do not merge this commit.

* Update api-site-config.md

* Update guides-navigation.md

* Update SideNav.js

* Update main.css

* Update SideNav.js

* Delete subcategory1.md

* Delete subcategory2.md

* Update sidebars.json
2019-01-23 14:13:27 -08:00
Marvin Chin
3ff79fceb1 docs: add missing trailing slash to sample site config base url (#1190) 2019-01-18 09:31:02 -08:00
Jake Bolam
c4a9b31984 feat: add custom commit message (#1136)
* feat: add custom commit message

Addresses: #1135

* Update publish-gh-pages.js

* add support to v2 as well

* docs: add them

* docs
2018-12-04 12:26:21 +08:00
Dom Corvasce
61078e38a9 feat: Allow modifying docs url prefix (#914)
* Allow other routes than /docs in the URL

siteConfig.js has a new mandatory field named *docsRoute* which default
value is 'docs' and that can be customized by the user.

This change will allow users who uses the library to host guides and
tutorials to customize their websites by assign 'docsRoute' values
like 'tutorials' or 'guides'.

Fixes #879

* Make "docsRoute" field optional

* Isolate docsRoute login in getDocsRoute function

* Rename docsRoute to docsUrl

* Run prettier

* Remove old folders

* fix: Restore docusaurus reference link

* fix: Add `docsUrl` param fallback. Refactor multiple function calls

* Fix linting errors

* Update description for docsUrl field

* Reduce redundant calls to getDocsUrl

* Replace a missed use case for `docsUrl` instead of the function call

* Move `getDocsUrl` out from `server/routing.js` to `server/utils.js`

**Why?**
Because `routing.js` is exporting all router RegEx's, and the
`getDocsUrl` suffices more as a util

* WiP: Align leading slashes and fix routing around `docsUrl`

Checklist:
- [x] Added `removeDuplicateLeadingSlashes` util to make sure there is only
one leading slash
- [-] Fix edge cases for routing:
  - [x] `docsUrl: ''`
  - [ ] `docsUrl: '/'`
  - [ ] make it work with languages
  - [ ] make it work with versioning

* Make leading slashes canonical cross routing and generated links

This ensures correct routing for customized `baseUrl` and `docsUrl`.

- Changed all routing functions to take `siteConfig` instead of
`siteConfig.baseUrl`
- Updated tests accordingly

* Alternative fallback for `docsUrl`

* rework/ fix implementation

* cleanup

* refactor and add docs for config props

* fix typo

* fix broken url
2018-11-28 15:34:16 +08:00
maxaggedon
c6f3f0958d feat: customizable search placeholder (#1126)
* feat: customizable search placeholder

* prettier
2018-11-23 14:27:59 -08:00
maxaggedon
2df14feafd feat: use 'sidebar_label' instead of 'title' in prev/next buttons (#1122)
* feat: use 'sidebar_label' instead of 'title' in prev/next buttons

* docs: update 'sidebar_label' description
2018-11-22 18:36:05 +08:00
tsmrachel
54b76628f1 docs: specify markdown flavor support (#1118)
* docs : #1108 specify markdown flavor support

* Update api-doc-markdown.md
2018-11-18 21:07:57 -08:00
Alexandre ZANNI
2bf2dfe173 docs: mention about website directory naming (#1106)
docs: mention about website directory naming
2018-11-11 15:14:39 -08:00
Andrew Shillito
8c7d89c667 docs: add info about setting custom doc path (#1098)
* docs: add info about setting custom ../docs folder name

* Update getting-started-preparation.md
2018-11-07 21:59:55 -08:00
aenuros
edde297504 docs: how to add "Copy" button to code blocks (#1047)
* Update guides-custom-pages.md

Guide on how to add "Copy" to clipboard buttons on code blocks in Docusaurus.

* Update guides-custom-pages.md

Changed wall of text to be a link to a gist describing the code you need to add to add copy clipboard

* Add to markdown instead

* Update guides-custom-pages.md
2018-10-24 01:52:55 -04:00
Yangshun Tay
ca7c3cebc1
docs: remove extra comma in site creation steps 2018-10-22 17:45:34 -04:00
M4rk9696
d1ced5ca13 docs: reword publish to GitHub Pages documentation (#1049)
* doc: Updating Using GitHub Pages Documentation

* docs: Rewording deploying to github pages

* docs: Review changes

* Update getting-started-publishing.md
2018-10-20 21:15:06 -07:00