Commit Graph

300 Commits

Author SHA1 Message Date
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
Fienny Angelina 8cf9afe4ac feat: add last contributor to each document (#980)
* add contributor list to each document

* handle case where there is no github repo

* Move to v1

* Revert "handle case where there is no github repo"

This reverts commit a76a887901.

* Revert "add contributor list to each document"

This reverts commit c0cc79f995.

* Add last updated by field

* -Include enableUpdateBy in the config
- Rename css class to be more general

* Fix lint

* Refactor :
- s/getGitlastupdated/getGitLastUpdatedTime
- refactor part in getGitLastUpdated[Time|By] that overlaps
- remove getAuthorInformation

* -Modify the display logic
-Refactor the utils, combine lastupdatedtime and lastupdatedby
-Replace the test

* Modify docs based on the display change

* Update docs for url and baseurl

For more clarity and to make relationship more clear

* Update support for Web App Manifest (#1046)

* misc: update nits

* misc: update nits
2018-10-18 00:59:16 -07:00
Tirth Bodawala 4a7e1ea189 Update support for Web App Manifest (#1046) 2018-10-17 10:21:10 -07:00
Joel Marcey a39d2b0280
Update docs for url and baseurl
For more clarity and to make relationship more clear
2018-10-17 10:20:35 -07:00
Alex Driedger a28ac3bf93 docs: update siteConfig documentation for publishing with GitHub Pages (#1038)
* Updated Publishing with GitHub Pages

Updated docs to resolve #1029

* Update getting-started-publishing.md
2018-10-15 10:18:22 -07:00
Tan Li Hau 1bc1762b02 docs: document process.env.BROWSER for start command (#1034)
* docs: document BROWSER

* Update api-commands.md
2018-10-14 12:28:50 -07:00
Tan Li Hau 1275005321 docs: reorganize siteConfig entry (#436) (#1027) 2018-10-12 09:00:24 -07:00
Yangshun Tay fe500dea82
fix: change subcategory format (#1026)
* fix: change subcategory format

* Fix sidebars

* Refactor

* Fix implementation

* Change format
2018-10-10 08:33:20 -07:00
Will Brock 954456088c feat: sub-categories in sidebar.json (#892)
* Add ability to specify sub categories in sidebar.json

* move v1 files to correct place

* refactor implementation

* refactor naming for implementation clarity
2018-10-08 16:09:29 +08:00
Amy Lam a364aa531c Fix typo in Getting Started docs (#1013) 2018-10-01 22:41:08 -07:00
Marvin Heilemann 8568a96e65 Added option for client to include there own remarkable config (#974)
* Added option for client to include there own remarkable config

* Better use merge here

* Added lodash ...

* Change use of lodash to deepmerge and added description to api site

* markdownConfig -> markdownOptions

* Update api-site-config.md

* remove 1.4 docs change

 since it is unrelated (the feature will only be available in next release)

* Run prettier
2018-09-20 15:00:59 +08:00
Eric Nakagawa ac01fcf881
Merge pull request #936 from wszgxa/add-docker-support
Add docker support
2018-09-06 11:20:11 -07:00
Eric Nakagawa 3094afdce3 Rewrote some of the new Docker copy. 2018-09-06 11:13:13 -07:00
endiliey b00b933ab9 docs nit 2018-09-06 01:59:16 +08:00
Ethan Marrs 4bc010bfcc Fix minor documentation wording issue (#945)
* The phrase "It has no inherit meaning" should probably be "It has no inherent meaning".
2018-09-05 17:36:07 +08:00
Hilu luke 969399c6c5 Enable passing attributes to scripts and links (#937) 2018-09-03 15:46:55 -07:00
hiluluke a1a26d1c2e Add docker support document 2018-09-03 13:21:06 +08:00
Tirth Bodawala 2cbfeffd81 Add support for Web App Manifest in siteConfig (#934)
* Add support for Web App Manifest in siteConfig

* Update api-site-config.md

* Update api-site-config.md
2018-09-02 10:25:15 -07:00
Shubham Bansal 1a572757f1 feat: last updated time in docs (#913)
* Adding last updated time for docs

* Making file path general and other suggested changes

* Checking if time returned is null due to absence of git or some other issue

* Adding option to enable/disable update time feature and test-doc

* Adding simple unit tests for getGitUpdateTime()

* nits & rewrote failing test

* consistent test naming

* Adding optional updateEnableTime in documentation

* package-lock & yarn.lock
2018-08-29 21:15:18 +08:00
Laxman cfabaedc99 Fix: conflicting strings issue in translations (#917)
* Fix conflicting strings issue in translations

* Preserve structure of `customTranslations`

* Use `deepmerge` to merge whole of `localized-strings`

* Simplify and make deep property access on an object safe

* Fix deep property accessor and rename it to idx
2018-08-29 00:04:02 +08:00
Joel Marcey 92f95df934
Update guides-translations.md for CircleCI 2.0
Ref: #350
2018-08-20 10:48:05 -07:00
Apurav Chauhan acd4f3f984 Update getting started page to be more intuitive (#900)
* Updating step 2 to be more intuitive

Use of word Github is very confusing. When starting, most of devs wont have an existing github repo. And normally not everyone will be using Github. Since devs will be following this step by step: we need to stress on telling them to create a new or use existing local project folder which may or may not be a github repo.

* Update getting-started-installation.md
2018-08-13 01:29:45 -07:00
Yangshun Tay d2b30dc3ed Revert "Add ability to specify sub categories in sidebar.json (#891)"
This reverts commit 16087b4428.
2018-08-06 18:58:54 -07:00
Will Brock 16087b4428 Add ability to specify sub categories in sidebar.json (#891) 2018-08-06 18:58:48 -07:00
Carol Willing dd9d05c84d Clarify content in the site prep doc (#889) 2018-08-05 20:05:15 -07:00
Carol Willing 29e71ebf53 Update installation doc (#888)
* Update installation doc

* add short phrase
2018-08-05 15:45:24 -07:00
John Reese 75538395be Fix table of contents documentation typo (#873) 2018-07-27 11:07:56 +07:00
Fabrizio Ferri-Benedetti a60fe1c052 Improve baseUrl documentation with an example (#863)
* Update with GH Enterprise instructions for baseUrl

* Update api-site-config.md

* simplify wordings
2018-07-20 22:33:27 +07:00
Steve Hook 22f3a85a49 add documentation regarding usage of nested docs + git ignore .idea (#860)
* add documentation regarding usage of nested docs + add .idea in .gitignore

* Remove 1.3.3, move to navigation & simplify wording

* add documentation for docusaurus >= v1.2.0 a well
2018-07-19 16:07:32 +07:00
Endilie Yacop Sucipto aa1f82649c
Search correct language and version for Docusaurus (#859) 2018-07-18 17:39:04 +07:00
Yangshun Tay 1094dbd352
CSS revamp - Improve typography and overall styling (#757)
* Improve CSS code

* Fix blog layout

* Fix

* Refactor onPageNav

* More fixes

* Fix docs nav

* Use alternative hack

* Tweak clearfix
2018-06-19 21:46:15 -07:00
Andrey Rublev 850e3003ca [docs] add note about babel cache to upgrade guide (#778)
for details see https://github.com/facebook/Docusaurus/issues/759
2018-06-15 10:32:35 -07:00
Jonathan Ingram 58fba70dea Add config option for setting title of the blog sidebar (#770)
* Allow controlling the title of the blog sidebar

* Update guides-blog.md
2018-06-15 00:08:34 -07:00
=^._.^= 62a2c7c1a5 Add option to disable live reload server during development (#766)
* add option to disable live reload server

* change live to watch, fix incorrect argument parsing code

* Update api-commands.md
2018-06-14 23:51:03 -07:00
Joel Marcey 608e2c85a2
Move custom translation strings to its own file (#775) 2018-06-14 17:25:29 -07:00
Gustavo Henke fd9a3ffb6d Cross repo publishing (#764) 2018-06-14 16:03:37 -07:00
Joel Marcey de8da1ca54
Better bash formatting for updating Docusaurus 2018-06-11 17:46:58 -07:00
Joel Marcey 7281c5632b
More details on updating Docusaurus for a site 2018-06-11 16:53:04 -07:00
Joel Marcey 902db36edb
Fix broken search guide formatting 2018-06-10 17:37:43 -07:00
Tim Kelly 976df54419 Add back information about extra search options (#756)
I added back information about extra search options for Algolia. A previous commit removed the section about extra search options, but it appears the information might actually be useful.
2018-06-10 17:32:04 -07:00
Endilie Yacop Sucipto c47af6be4b Enable custom meta description for custom pages (#752) 2018-06-10 09:35:30 -07:00
Yangshun Tay 18c01327a3 Reformat, proofread and tidy up docs (#749) 2018-06-10 08:02:04 -07:00
Yangshun Tay ffe782a669
Remove outdated restriction for docs nesting (#746) 2018-06-10 01:21:06 -07:00
Endilie Yacop Sucipto c8bc00a3a7 Enable using Prism for syntax highlighting (#735)
* Enable user to use prism.js as syntax highlighter

* add package-lock

* if 'usePrism' is true, use prismjs on all languages

* don't get lang by hljs if use prism

* Update api-site-config.md

* Update api-doc-markdown.md

* only load prism css when usePrism is true
2018-06-09 11:38:01 -07:00
vacarsu 16da2fdbf6 Update getting-started-installation.md (#742)
* Update getting-started-installation.md

Add minimum yarn version

* Add a period

* Update getting-started-installation.md
2018-06-08 17:09:34 -07:00
Endilie Yacop Sucipto d04b3ca87b Enable sub-directories in docs/ (#705) 2018-06-07 07:41:28 -07:00
Endilie Yacop Sucipto 31f0c27f81 Enable clean / extension-less url (#677) 2018-06-06 13:37:49 -07:00
Lespagnol Rémy aee255219b Add a scroll to top button siteConfig option (#723) 2018-06-06 12:34:32 -07:00
ranolf 2bd9a148c1 Support publishing to Github Enterprise hosting (#689)
* Added support for Github Enterprise GH Pages

* Fixed with prettier output

* Tweak

* Tweak

* Tweak
2018-06-02 15:59:29 -07:00
Endilie Yacop Sucipto e91e648844 Add Travis CI guide (#721) 2018-06-02 11:25:13 -07:00
Endilie Yacop Sucipto fa20c93d5c Add documentation for setting title of custom pages (#712)
* add customtitle for page doc

* Update api-pages.md

* Update api-pages.md
2018-05-30 22:16:50 -07:00
Dongwoo Gim 5272944626 Fix typo error on `Tips & Tricks` (#708) 2018-05-28 21:17:30 -07:00
Yangshun Tay 454e3d359f
Update directory tree (#696) 2018-05-23 21:01:33 -07:00
Sébastien Loix d14d3c2092 Add documentation about using development server behind a proxy #603 (#688)
* Add documentation to launch development server behind a proxy #603

* Update getting-started-installation.md

* Update getting-started-installation.md
2018-05-22 22:14:24 -07:00
Endilie Yacop Sucipto aae106c018 Enable Facebook comments on blog posts (#673)
* Enable comment on blog post

* adjust css

* Tweak
2018-05-19 09:26:57 -07:00
Endilie Yacop Sucipto f8521c2fe1 Enhance footer with Facebook and Twitter buttons (#666)
* enhance footer with social media buttons

* Update api-site-config.md

* Update Footer.js

* fix minor issue on social-footer

* update facebookAppId description in api-site-config

* rm heading & pad footer social button

* Update api-site-config.md
2018-05-17 21:26:06 -07:00
Endilie Yacop Sucipto c730bc7bb7 Improve publishing guide on Github Pages (#664)
Docusaurus docs is confusing, it should be https://facebook.github.io/Docusaurus when referring to GitHub Pages URL, not the custom domain at https://docusaurus.io/
2018-05-15 18:55:42 -07:00
Joel Marcey f315d02e58
Circle doc updates 2018-05-11 18:30:59 -07:00
Yangshun Tay 87a2392d6e Make CLI docs futureproof (#660) 2018-05-10 20:52:04 -07:00
Ahmad Alfy ab6bab9f8d [Feature] Introducing image compression using imagemin (#654)
* Introduce imagemin for compressing images

* Replace original images with the optimized ones

* Add imagemin-svgo to dependencies

* Remove console statement, replace let with const

* Replace let with const

* Add --skip-image-compression

* Run Prettier
2018-05-09 16:59:36 -07:00
Erin Teo 5771549e75 Rename latestVersion to defaultVersion (#639)
* Rename lastVersion to defaultVersion

* Added defaultVersionShown to site-config doc

* Remove defaultVersionShown from siteConfig

* Update api-site-config.md
2018-05-05 17:24:39 -07:00
Matías Olivera 34d86f760b Fix assets directory path in "Tips & Tricks" (#630) 2018-05-03 08:16:15 -07:00
SoonaMata 0d7af296b5 Update documentation, add link for SSH key (#627)
Came across issue with SSH and added the link to help other beginners who may have the same issue.
2018-05-02 14:06:56 -07:00
Tim Carry 5afc0b0a1c Simplify DocSearch documentation (#624)
* Simplifying DocSearch documentation

I slightly rewrote the DocSearch documentation. The main three points are:

- I explained a bit more how DocSearch works (trying to explain that it's an external service that requires the website to be online)
- I removed mentions to the _search_ API key as in that case, it's always a _search_ (as opposed to _admin_) API key that is used
- I removed the part about faceting on the version. I thought it was confusing as without a specific UI to display the faceting, this won't do much. To use it properly, one will need to dig more into layouts. I might submit a PR about that later, but as it was today I think it would just create confusing rather that adding value

Hope that helps :)

* Make links URLs inline
2018-05-02 08:27:17 -07:00
Amit Harlev a7b65bb6f4 Incorrect file path for netlify publishing (#622)
I tried following the guide to publish my website on Netlify (on April 29, 2018), however it did not work until I changed the path to include "website/".
2018-04-29 14:13:17 -07:00
Fabrizio Ruggeri 976ae770b5 Allow Google Analytics to use gtag.js (#601)
* Moved google analytics script to head

The code now uses the new gtag script to track the website on google analytics.
The migration is explained [here](https://developers.google.com/analytics/devguides/collection/gtagjs/migration).
This will help to solve issues such as #375.
As indicated at https://support.google.com/analytics/answer/1008080
the analytics code must be placed in the head tag, so it is moved there.

* Add a boolean to use the new gtag library

* Update api-site-config.md
2018-04-29 10:44:11 -07:00
Yangshun Tay a9a39817d4
Use proper syntax highlighting for code blocks (#615)
* Better syntax highlighting

* Better syntax highlighting
2018-04-27 22:51:38 -07:00
Yangshun Tay 327ef85770
Improve directory file tree (#614) 2018-04-27 22:47:14 -07:00
Darragh Grace 91897191b6 Adding info for Hosting Static HTML Pages due to recent css changes (#611)
Adding info for Hosting Static HTML Pages
2018-04-27 09:13:42 -07:00
Yangshun Tay 7ea0f5a8cf s/Github/GitHub (#608) 2018-04-26 09:43:47 -07:00
Joel Marcey 6d2462e84a Add docs for docs-based landing page
Fixes #459
2018-04-23 15:31:10 -07:00
Eric Nakagawa 4e575e9234 Documents `Blog Only` Mode and Netlify Hosting (#595)
* Documentation, newest: Add steps for hosting on Netlify

* Documents how to run a blog-only site
2018-04-23 13:45:02 -07:00
Long Mai 33d4e4a4ec Simplify installation steps (#519)
* simplify installation steps

Since docusaurus-init is run seldomly, npx keeps it simpler,
and subsequent runs will be using the latest version.

Outdated provides more meaningful view of current and latest version

* add more doc on who can use npx

* Make yarn and npm commands more specific
2018-04-23 00:13:29 -07:00
huang.xinghui aa32ff4a55 Add customize highlight.theme custom path support (#517)
* add themeUrl option to support custom theme file path

* Update api-site-config.md
2018-04-19 08:04:49 -07:00
Amy Lam 57cddb4d08 Allow customizing of blog author image URL documentation (#577)
* Rename authorImage to authorImageURL for clarity

Update documentation

* Fix typo

* Add documentation for authorImageURL

* Add support for authorImage

We will remove support for authorImage in favor of authorImageURL, after we remove authorImage from react-native-website

* Update guides-blog.md

* Update guides-blog.md
2018-04-17 23:15:27 -07:00
Joel Marcey 47d08bf1da
Update site config example in docs 2018-04-17 21:15:50 -07:00