Commit graph

52 commits

Author SHA1 Message Date
Sébastien Lorber
f5ae537d3e
fix(theme): make warning a first-class admonition, and deprecate caution admonition (#9308) 2023-09-15 10:48:21 +02:00
Sébastien Lorber
bf913aea2a
feat: upgrade to MDX v2 (#8288)
Co-authored-by: Armano <armano2@users.noreply.github.com>
2023-04-21 19:48:57 +02:00
Sébastien Lorber
97caab16d4
docs: create Docusaurus v2.4.0 release docs + changelog + release blog post (#8811) 2023-03-23 19:32:09 +01:00
Sébastien Lorber
de6ec3db18
docs: create Docusaurus v2.3.0 release docs + changelog + release blog post (#8586) 2023-01-27 17:02:28 +01:00
Joshua Chen
3526059214
chore: bump dependencies major versions (#8537) 2023-01-10 15:22:19 -05:00
Serenus
773529a3bc
docs(website): fix broken external links wrongly modified to use the .mdx extension (ex: github README.mdx) (#8509)
Co-authored-by: sebastienlorber <lorber.sebastien@gmail.com>
2023-01-05 13:28:30 +01:00
Sébastien Lorber
3adc4ea809
docs: blog + community + dogfood docs should use .mdx extension (#8507) 2023-01-04 19:59:56 +01:00
Sébastien Lorber
41c981aa9f
docs: create Docusaurus v2.2.0 release docs + changelog + release blog post (#8265) 2022-10-29 12:59:20 +02:00
Joshua Chen
36db64ed1d
docs: improve alt messages (#8047) 2022-09-04 01:33:25 -04:00
Sébastien Lorber
29703da188
fix(website): fix blog post social card (#8042) 2022-09-02 14:43:20 +02:00
Sébastien Lorber
56feb41445
docs: create Docusaurus v2.1.0 release docs + changelog + release blog post (#8036) 2022-09-02 12:39:32 +02:00
Sébastien Lorber
e519858ea7
docs: update Hacker News + Product Hunt links (#7874)
update HN + ProductHunt links
2022-08-01 18:33:28 +08:00
Joshua Chen
3a0e90eacd
chore: fix blog-only test failures (#7865) 2022-08-01 14:14:13 +08:00
Sébastien Lorber
79360c6ae6
docs: publish 2.0.0 release blog post + adapt website for the launch (#7863) 2022-08-01 07:51:03 +02:00
Joshua Chen
e12a2efaeb
docs: normalize capitalization (#7619) 2022-06-15 13:04:33 +08:00
Joshua Chen
aeb6c971c0
docs: normalize capitalization (#7613) 2022-06-14 14:01:06 +08:00
Joshua Chen
ff96606865
docs: fix some casing inconsistencies (#7081) 2022-03-31 20:23:44 +08:00
Nayan Patel
1c91d2f20e
docs: fix broken links (#6817)
* Fix a broken showcase GitHub URL

* Seems like this site is no longer Open Source?

* Seems like this site is no longer open source?

* Fix as previous link leaded to a 404

* Replaces the 404 error of previous page.

Not sure if this is the correct link to be placed there.

* Fixes 404 error ;)
2022-03-03 07:02:57 +08:00
Joshua Chen
6cbc58943e
feat: allow blog authors email (#6783) 2022-03-02 16:28:17 +01:00
Nick Schonning
e3be77081c
chore: typo colocation -> collocation (#6464) 2022-01-25 11:06:01 +08:00
Nick Schonning
521eb119a7
chore: add cSpell for spell checking (#6456)
* chore: Add cSpell for spell checking

* chore: exclude map files and remove dups

* chore: exclude more binary files

* chore: remove MD headings

* Update .cspell.json

* fix a few spellings

* fix more

* fix

Signed-off-by: Joshua Chen <sidachen2003@gmail.com>

* fix a few

* oops

Co-authored-by: Joshua Chen <sidachen2003@gmail.com>
2022-01-25 09:40:02 +08:00
Joshua Chen
a41a5c328c
docs: 2021 recap blog post (#6334)
* docs: 2021 recap blog post

* minor wordings

* Misc copy changes

* Add thumbnail

* nit

* use en dash

* Update screenshots

* polish

* Add image to summary

* Tweak introduction

* oops...

* nits

Co-authored-by: Yangshun Tay <tay.yang.shun@gmail.com>
2022-01-24 22:05:59 +08:00
Sébastien Lorber
14a252ca54
docs(website): Add docsearch migration blog post (#5967)
Co-authored-by: Clément Vannicatte <20689156+shortcuts@users.noreply.github.com>
Co-authored-by: Joel Marcey <joelm@fb.com>
Co-authored-by: Samuel Bodin <samuel.bodin@algolia.com>
2021-11-21 16:25:35 +01:00
Alexey Pyltsyn
3551212d50
docs: update links to default translations dir (#5979) 2021-11-20 18:44:28 +01:00
Alexey Pyltsyn
63bd6b9025
refactor: define own translations in other themes (#5849)
Co-authored-by: Armano <armano2@users.noreply.github.com>
2021-11-20 16:35:27 +01:00
Joshua Chen
493225a3c6
feat(plugin-blog): multi-authors support + authors.yml global configuration (#5396)
* Complete function

Signed-off-by: Josh-Cena <sidachen2003@gmail.com>

* A lot of blank lines

Signed-off-by: Josh-Cena <sidachen2003@gmail.com>

* More lenient validation

Signed-off-by: Josh-Cena <sidachen2003@gmail.com>

* Remove or

Signed-off-by: Josh-Cena <sidachen2003@gmail.com>

* Simpler logic

Signed-off-by: Josh-Cena <sidachen2003@gmail.com>

* Expand docs

Signed-off-by: Josh-Cena <sidachen2003@gmail.com>

* Better docs

Signed-off-by: Josh-Cena <sidachen2003@gmail.com>

* Dogfood

Signed-off-by: Josh-Cena <sidachen2003@gmail.com>

* More writeup

Signed-off-by: Josh-Cena <sidachen2003@gmail.com>

* Polish

Signed-off-by: Josh-Cena <sidachen2003@gmail.com>

* Polish

Signed-off-by: Josh-Cena <sidachen2003@gmail.com>

* Move mergeAuthorMap to authors.ts

Signed-off-by: Josh-Cena <sidachen2003@gmail.com>

* Unbreak relative assets

* Update docs

* Clarify in docs

* simplify feed authors

* rename authorMap -> authorsMap

* mergeAuthorsMap -> getBlogPostAuthors

* website => 5 blog posts per page

* improve authors map file

* Extract new theme authors components + display in row

* add comment for meta array syntaxes

* blog => getPathsToWatch should watch authorsMap file

* remove useless v1 blog FBID frontmatter

* keep older frontmatter syntax for now

* revert blog frontmatter

* Better console message

* better blog authors frontmatter impl

* add multi authors to beta blog post + fix some authors margins

* fix React key

* Refactor: mdx loader should support a more flexible assets system (poc, not documented yet)

* better display of blog post authors: adapt layout to authors count + add line clamp

* smaller local image

* fix blog feed tests

* fix blog frontmatter tests + improve validation schema

* add more frontmatter tests

* add tests for getAuthorsMapFilePath

* tests for validateAuthorsMapFile

* add tests for readAuthorsMapFile

* test getAuthorsMap

* exhaustive tests for getBlogPostAuthors

* fix remaining tests

* missing blog plugin author tests

* fix windows tests

* improve blog multi-author's doc

* Use new format in init template

Signed-off-by: Josh-Cena <sidachen2003@gmail.com>

* Improve error message

Signed-off-by: Josh-Cena <sidachen2003@gmail.com>

* update feed snapshot

* blog authors: limit to 2 cols + fix margins for no authors

* minor doc improvements

* better init template blog posts, demonstrating Blog features

* replace the legacy blog author frontmatter in remaining places

* Prefer using clsx

Signed-off-by: Josh-Cena <sidachen2003@gmail.com>

* cleanup getColClassName

* remove blog author name/title line-clamping

Co-authored-by: slorber <lorber.sebastien@gmail.com>
2021-08-26 12:21:58 +02:00
Paul O’Shannessy
8341527fc9
refactor: rename Git master branch to main (#5345)
* Prepare to renaming master branch to main

* Update CONTRIBUTING.md

* Update packages/docusaurus-migrate/src/__tests__/__fixtures__/missing_version_website/website/package.json

* Update packages/docusaurus-migrate/src/__tests__/__fixtures__/complex_website/website/package.json

* Update packages/docusaurus-migrate/src/__tests__/__fixtures__/simple_website/website/package.json

* missing master -> main replaces

* useless char

* For GH Pages org deploy, DEPLOYMENT_BRANCH env is now required

* fix versioning page

* fix vercel links

* update deployment.mdx

Co-authored-by: Sébastien Lorber <slorber@users.noreply.github.com>
Co-authored-by: slorber <lorber.sebastien@gmail.com>
2021-08-17 18:41:53 +02:00
Sébastien Lorber
cabb768473
feat: blog posts support /YYYY/MM/DD/blog-post/index.md pattern + blog frontmatter can reference relative images (#5309)
* POC of blog post folder

* add parseBlogFileName with tests + refactor and extract processBlogSourceFile in separate method

* improve blog date pattern doc + link from content plugin guides to API ref docs

* Some FrontMatter fields should be able to reference relative image assets, converted to Webpack require calls and exposed as frontMatterAssets

* remove log
2021-08-06 17:51:59 +02:00
Sébastien Lorber
b835aecaec
chore: removal of Docusaurus v1 code from master (it is now available on docusaurus-v1 branch) (#4902) 2021-06-10 10:54:07 +02:00
Yangshun Tay
f2927a9fc4
Move Docusaurus 1 files into directory (#966)
* Move Docusaurus 1 into v1 directory

* Update Circle CI commands for new v1 dir

* Remove OC

* Fix tests
2018-09-18 00:58:07 +08:00
Joel Marcey
0bf253b790
Update 2018-09-11-Towards-Docusaurus-2.md 2018-09-12 13:18:15 -07:00
Endilie Yacop Sucipto
9367b3b63b
chore: update blog post
Not a time-space complexity, juat a space complexity. In fact, it builds faster in new version due to not having to find the version fallback
2018-09-12 11:15:49 +08:00
Yangshun Tay
99c426a4ed
Add mission statement into blog post 2018-09-12 08:57:48 +08:00
Endilie Yacop Sucipto
85f6c19710 blog: add a sneak-peek post about Docusaurus v2 (#952)
* blog: add a blogpost talking about v2 plan & work

* proofread blogpost

* revision layout statement

* Update 2018-09-09-Towards-Docusaurus-2.0.md

* rename file from suffix '2.0' -> '2'

* proofread with grammarly :p

* rename date to 10 september

* add frequently asked questions

* rename #845 to Rrenaming docs breaks links in old versions

* edit final thoughts/conclusions a bit

* proofread again ...

* Readability updates

* change date to 11 sept & fix typo

* into just a bunch-> into a bunch

* last proofread/ fix typo

* Update 2018-09-11-Towards-Docusaurus-2.md
2018-09-12 07:44:24 +08:00
Jaril Valenciano
ba76eddc87 Convert Docusaurus banner image into SVG (#915)
* replaced readme header image

Changed from .PNG to .SVG to eliminate blurriness on high-resolution screens

* compressed header .SVG

* Replaced header image in blog post

Blogpost: Introducing Docusaurus
2018-08-25 12:44:28 -07:00
Rhys Bower
c0aa98bd55 Switch Jest URL to jestjs.io (#807) 2018-06-26 21:07:58 -07:00
Yangshun Tay
0fff8788fe Add author Twitter handle to blog (#626) 2018-05-03 10:49:57 -07:00
Christine Abernathy
bcf0d1bd8c Blog post for Profilo conversion (#623) 2018-04-30 10:21:01 -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
Joel Marcey
001eae7003 Update the initial blog post clarifying JS/React vs Jekyll 2018-04-12 09:11:36 -07:00
Sam Brown
f253307f72 Small sentence change in blog post (#547) 2018-04-12 08:13:22 -07:00
Amy Lam
c2cd169b64 Add alt tags to images for a11y (#529)
- Add imageAlt to GridBlock
- Set alt equal to `user.caption` for mapped users
- Set alt equal to `post.author` for blog posts
- Update documentation
2018-04-07 19:13:12 -07:00
Thomas Broadley
b5fefcc676 docs: fix typos (#327) 2017-12-19 21:39:18 -08:00
Darren Richards
621bd29e7a Fix typo (#286) 2017-12-14 11:07:21 -08:00
Joel Marcey
67dc79446a Move docusaurus image to community section in blog post 2017-12-14 09:44:12 -08:00
Joel Marcey
d6fb14cfa4
Add introductory blog post (#279)
* Add introductory blog post

For launch!

\o/

* Update post to launch date

* Add ogImage and fix how we get og:Description

Plus a few updates to the post

* Remove some code block info
2017-12-14 09:32:49 -08:00
Eric Nakagawa
fa1ec70432 Bug fixes in generatejs (#169)
* Misc cleanups related to console.log messages in yarn build

* Fixes https://github.com/facebookexperimental/Docusaurus/issues/96
2017-10-26 16:13:56 -07:00
Eric Nakagawa
55b0f33f2a Allows periods in blog file names -- will allow for version numbers, etc (#163)
* Allows periods in blog file names -- will allow for version numbers, etc

* Removed debug lines...
2017-10-24 19:27:37 -07:00
Eric Nakagawa
c2243a3c20 Only show 'Read More' button on blog list page when post has <!-- truncate --> token (#161)
* Only show 'Read More' button on blog list page when the text includes a <truncate> token

* Remove console.log
2017-10-24 13:46:42 -07:00