Skip to content

Commit

Permalink
Update things for v2 (#1926)
Browse files Browse the repository at this point in the history
  • Loading branch information
wooorm committed Feb 1, 2022
1 parent a5daaad commit adc64ec
Show file tree
Hide file tree
Showing 35 changed files with 156 additions and 279 deletions.
84 changes: 60 additions & 24 deletions docs/blog/v2.server.mdx
Expand Up @@ -3,21 +3,10 @@ export const info = {
author: [
{name: 'Titus Wormer', github: 'wooorm', twitter: 'wooorm'}
],
published: new Date('2021-11-01'),
modified: new Date('2021-11-01')
published: new Date('2022-02-01'),
modified: new Date('2022-02-01')
}

<Note type="important">
**Note**: V2 is around the corner.
This website is for that.
It hasn’t been released yet.
But you can try out the RC.
You can be of great help by reading through these docs and letting us know
what’s confusing or wrong or other suggestions you have.
See [§ Support][support] for where to ask questions and
[§ Contribute][contribute] for how to help.
</Note>

<Note type="info">
**Note**: Info on how to migrate is available in our
[Version 2 migration guide][migrating].
Expand Down Expand Up @@ -139,7 +128,7 @@ We also added support for JavaScript expressions, take for example:
{name: 'Jane', email: 'hi@jane.com'},
{name: 'John', twitter: '@john2002'}
]
export const published = new Date('2021-11-01')
export const published = new Date('2022-02-01')

Written by: {new Intl.ListFormat('en').format(authors.map(d => d.name))}.

Expand All @@ -151,7 +140,7 @@ We also added support for JavaScript expressions, take for example:
```jsx path="equivalent.jsx" copy=no
<>
<p>Written by: Jane and John.</p>
<p>Published on: November 1, 2021.</p>
<p>Published on: February 1, 2022.</p>
</>
```
</div>
Expand Down Expand Up @@ -267,15 +256,64 @@ When you’re ready to migrate, please see the
## Thanks
<Note type="important">
**Important**: To do!
We’ll do this when v2 actually hits.
So there’s still time to get your name here 😉
</Note>
We’d like to say thanks to all our contributors and our happy users.
Special thanks to
...
Thanks to John Otander ([**@johno**](https://github.com/johno)),
Christian Murphy ([**@ChristianMurphy**](https://github.com/ChristianMurphy)),
JounQin ([**@JounQin**](https://github.com/JounQin)),
Jack Bates ([**@jablko**](https://github.com/jablko)),
Sam Chen ([**@chenxsan**](https://github.com/chenxsan)),
Sam Robbins ([**@samrobbins85**](https://github.com/samrobbins85)),
Remco Haszing ([**@remcohaszing**](https://github.com/remcohaszing)),
LB ([**@laurieontech**](https://github.com/laurieontech)),
Gabriel Kirkley ([**@gdgkirkley**](https://github.com/gdgkirkley)>),
Hung-I Wang ([**@Gowee**](https://github.com/Gowee)),
Ilham Wahabi ([**@iwgx**](https://github.com/iwgx)),
Kaito Sugimoto ([**@HelloRusk**](https://github.com/HelloRusk)),
Karl Horky ([**@karlhorky**](https://github.com/karlhorky)),
Katie Hughes ([**@glitteringkatie**](https://github.com/glitteringkatie)),
Lachlan Campbell ([**@lachlanjc**](https://github.com/lachlanjc)),
Marcy Sutton ([**@marcysutton**](https://github.com/marcysutton)),
Marius Gundersen ([**@mariusGundersen**](https://github.com/mariusGundersen)),
Marius-Remus Mate,
Mark Skelton ([**@mskelton**](https://github.com/mskelton)),
Martin V ([**@ndresx**](https://github.com/ndresx)),
Matija Marohnić ([**@silvenon**](https://github.com/silvenon)),
Michael Oliver ([**@michaeloliverx**](https://github.com/michaeloliverx)),
Michaël De Boey ([**@MichaelDeBoey**](https://github.com/MichaelDeBoey)),
Muescha ([**@muescha**](https://github.com/muescha)),
Norviah ([**@Norviah**](https://github.com/Norviah)),
Paul Scanlon ([**@PaulieScanlon**](https://github.com/PaulieScanlon)),
Peter Mouland ([**@peter-mouland**](https://github.com/peter-mouland)),
Prince Wilson ([**@maxcell**](https://github.com/maxcell)),
Rafael Almeida ([**@rafaelalmeidatk**](https://github.com/rafaelalmeidatk)),
Rodrez ([**@rodrez**](https://github.com/rodrez)),
Rongjian Zhang ([**@pd4d10**](https://github.com/pd4d10)),
Taeheon Kim ([**@lonyele**](https://github.com/lonyele)),
Tom Parker-Shemilt ([**@palfrey**](https://github.com/palfrey)),
Try Ajitiono ([**@imballinst**](https://github.com/imballinst)),
Yamagishi Kazutoshi ([**@ykzts**](https://github.com/ykzts)),
Yoav Kadosh ([**@ykadosh**](https://github.com/ykadosh)),
Yordis Prieto ([**@Yordis**](https://github.com/Yordis)),
Adrian Foong ([**@adrfoong**](https://github.com/adrfoong)),
Dan Abramov ([**@gaearon**](https://github.com/gaearon)),
[**@ihupoo**](https://github.com/ihupoo),
[**@nikhog**](https://github.com/nikhog),
[**@redallen**](https://github.com/redallen),
Akshay Kadam ([**@deadcoder0904**](https://github.com/deadcoder0904)),
я котик пур-пур ([**@mvasilkov**](https://github.com/mvasilkov)),
Anders D. Johnson ([**@AndersDJohnson**](https://github.com/AndersDJohnson)),
Andrew Aylett ([**@andrewaylett**](https://github.com/andrewaylett)),
Ankeet Maini ([**@ankeetmaini**](https://github.com/ankeetmaini)),
Biswas Nandamuri ([**@Biswas-N**](https://github.com/Biswas-N)),
Bret ([**@bcomnes**](https://github.com/bcomnes)),
Chris Chinchilla ([**@ChrisChinchilla**](https://github.com/ChrisChinchilla)),
Christopher Biscardi ([**@ChristopherBiscardi**](https://github.com/ChristopherBiscardi)),
Dan Overton ([**@dan-overton**](https://github.com/dan-overton)),
Domitrius ([**@domitriusclark**](https://github.com/domitriusclark)),
Dovi Winberger ([**@dowi**](https://github.com/dowi)),
Emmie Päivärinta ([**@emmiep**](https://github.com/emmiep)),
Eugene Ghanizadeh ([**@loreanvictor**](https://github.com/loreanvictor)),
and anyone we may have forgotten.
[what]: /docs/what-is-mdx/
Expand Down Expand Up @@ -304,6 +342,4 @@ and anyone we may have forgotten.
[types-mdx]: https://github.com/DefinitelyTyped/DefinitelyTyped/tree/HEAD/types/mdx
[support]: /community/support/
[contribute]: /community/contribute/
2 changes: 1 addition & 1 deletion docs/community/contribute.server.mdx
Expand Up @@ -5,7 +5,7 @@ export const info = {
{name: 'Titus Wormer', github: 'wooorm', twitter: 'wooorm'}
],
published: new Date('2018-11-04'),
modified: new Date('2021-11-01')
modified: new Date('2022-01-25')
}

# Contribute
Expand Down
2 changes: 1 addition & 1 deletion docs/community/sponsor.server.mdx
Expand Up @@ -4,7 +4,7 @@ export const info = {
{name: 'Titus Wormer', github: 'wooorm', twitter: 'wooorm'}
],
published: new Date('2021-10-06'),
modified: new Date('2021-11-01')
modified: new Date('2022-01-25')
}

# Sponsor
Expand Down
2 changes: 1 addition & 1 deletion docs/community/support.server.mdx
Expand Up @@ -5,7 +5,7 @@ export const info = {
{name: 'Titus Wormer', github: 'wooorm', twitter: 'wooorm'}
],
published: new Date('2019-07-03'),
modified: new Date('2021-11-01')
modified: new Date('2022-01-25')
}

# Support
Expand Down
15 changes: 0 additions & 15 deletions docs/docs/extending-mdx.server.mdx
Expand Up @@ -8,17 +8,6 @@ export const info = {
modified: new Date('2021-11-01')
}

<Note type="important">
**Note**: V2 is around the corner.
This website is for that.
It hasn’t been released yet.
But you can try out the RC.
You can be of great help by reading through these docs and letting us know
what’s confusing or wrong or other suggestions you have.
See [§ Support][support] for where to ask questions and
[§ Contribute][contribute] for how to help.
</Note>

# Extending MDX

This article explains how to extend MDX content—specifically, how to *transform*
Expand Down Expand Up @@ -178,7 +167,3 @@ For info on the node types that represent MDX specific features, see
[syntax-tree]: /packages/remark-mdx/#syntax-tree

[playground]: /playground/

[support]: /community/support/

[contribute]: /community/contribute/
35 changes: 5 additions & 30 deletions docs/docs/getting-started.server.mdx
Expand Up @@ -5,20 +5,9 @@ export const info = {
{name: 'Titus Wormer', github: 'wooorm', twitter: 'wooorm'}
],
published: new Date('2021-10-05'),
modified: new Date('2021-11-01')
modified: new Date('2022-02-01')
}

<Note type="important">
**Note**: V2 is around the corner.
This website is for that.
It hasn’t been released yet.
But you can try out the RC.
You can be of great help by reading through these docs and letting us know
what’s confusing or wrong or other suggestions you have.
See [§ Support][support] for where to ask questions and
[§ Contribute][contribute] for how to help.
</Note>

# Getting started

This article explains how to integrate MDX into your project.
Expand Down Expand Up @@ -318,11 +307,6 @@ If you use more modern JavaScript features than what your users support,
See also [¶ Create React App (CRA)][cra], [¶ Next.js][next], and
[¶ Vue CLI][vue-cli], if you’re using webpack through them, for more info.

<Note type="info">
**Note**: getting an error `ERR_VM_DYNAMIC_IMPORT_CALLBACK_MISSING`?
See [this note on `webpack-cli`](/packages/loader/#note-webpack-cli).
</Note>

### Build systems

#### Snowpack
Expand Down Expand Up @@ -395,10 +379,10 @@ which you’re likely using, for more info.

<Note type="info">
**Note**: to support ESM in `vue.config.js` or `vue.config.mjs`, you currently
have to use their v5.0.0-beta.
have to use their v5.0.0-rc.
See [`v5.0.0-beta.0`](https://github.com/vuejs/vue-cli/releases/tag/v5.0.0-beta.0)
in their changelog for more info.
Their latest beta release is currently `v5.0.0-beta.6`.
Their latest beta release is currently `v5.0.0-rc.2`.
</Note>

#### WMR
Expand Down Expand Up @@ -580,13 +564,6 @@ There is no need to configure your JSX runtime as React is already set up.
See also [¶ Webpack][webpack] and [¶ React][react], which you’re using, for
more on those tools.

<Note type="info">
**Note**: to support ESM in Next.js, you currently have to set a flag:
`experimental: {esmExternals: true}` in `next.config.js`.
See [ES Modules Support](https://nextjs.org/blog/next-11-1#es-modules-support)
in their Next.js 11.1 blog post for more info.
</Note>

#### Parcel

[Parcel 2](https://v2.parceljs.org) has their own plugin to support MDX.
Expand Down Expand Up @@ -825,6 +802,8 @@ See their readmes on how to configure them.

[jsx]: #jsx

[support]: /community/support/

[what]: /docs/what-is-mdx/

[use]: /docs/using-mdx/
Expand Down Expand Up @@ -898,7 +877,3 @@ See their readmes on how to configure them.
[gatsby]: #gatsby

[docusaurus]: #docusaurus

[support]: /community/support/

[contribute]: /community/contribute/
13 changes: 0 additions & 13 deletions docs/docs/troubleshooting-mdx.server.mdx
Expand Up @@ -10,17 +10,6 @@ export const info = {

{/* lint disable maximum-heading-length */}

<Note type="important">
**Note**: V2 is around the corner.
This website is for that.
It hasn’t been released yet.
But you can try out the RC.
You can be of great help by reading through these docs and letting us know
what’s confusing or wrong or other suggestions you have.
See [§ Support][support] for where to ask questions and
[§ Contribute][contribute] for how to help.
</Note>

<Note type="info">
**Note**: Had trouble with something that wasn’t explained here but should be?
Please let us know.
Expand Down Expand Up @@ -451,8 +440,6 @@ still tags open.
See the rules on
Interleaving in § What is MDX?](/docs/what-is-mdx/#interleaving)

[support]: /community/support/

[contribute]: /community/contribute/

[what]: /docs/what-is-mdx/
Expand Down
17 changes: 1 addition & 16 deletions docs/docs/using-mdx.server.mdx
Expand Up @@ -5,20 +5,9 @@ export const info = {
{name: 'Titus Wormer', github: 'wooorm', twitter: 'wooorm'}
],
published: new Date('2021-09-30'),
modified: new Date('2021-11-01')
modified: new Date('2021-11-14')
}

<Note type="important">
**Note**: V2 is around the corner.
This website is for that.
It hasn’t been released yet.
But you can try out the RC.
You can be of great help by reading through these docs and letting us know
what’s confusing or wrong or other suggestions you have.
See [§ Support][support] for where to ask questions and
[§ Contribute][contribute] for how to help.
</Note>

# Using MDX

This article explains how to use MDX files in your project.
Expand Down Expand Up @@ -456,7 +445,3 @@ No component is used for `h1`.
[vue]: /docs/getting-started/#vue

[toc]: /table-of-components/

[support]: /community/support/

[contribute]: /community/contribute/
15 changes: 0 additions & 15 deletions docs/docs/what-is-mdx.server.mdx
Expand Up @@ -9,17 +9,6 @@ export const info = {
modified: new Date('2021-11-01')
}

<Note type="important">
**Note**: V2 is around the corner.
This website is for that.
It hasn’t been released yet.
But you can try out the RC.
You can be of great help by reading through these docs and letting us know
what’s confusing or wrong or other suggestions you have.
See [§ Support][support] for where to ask questions and
[§ Contribute][contribute] for how to help.
</Note>

# What is MDX?

This article explains what the MDX format is.
Expand Down Expand Up @@ -368,7 +357,3 @@ the heading.
[using-plugins]: /docs/extending-mdx/#using-plugins
[iife]: https://developer.mozilla.org/en-US/docs/Glossary/IIFE
[support]: /community/support/
[contribute]: /community/contribute/
4 changes: 2 additions & 2 deletions docs/guides/math.server.mdx
Expand Up @@ -5,7 +5,7 @@ export const info = {
{name: 'Titus Wormer', github: 'wooorm', twitter: 'wooorm'}
],
published: new Date('2021-10-06'),
modified: new Date('2021-11-01')
modified: new Date('2022-02-01')
}

# Math
Expand Down Expand Up @@ -75,7 +75,7 @@ async function main() {
At the time of writing, the last version is:

```html
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/katex@0.13.13/dist/katex.min.css" integrity="sha384-RZU/ijkSsFbcmivfdRBQDtwuwVqK7GMOw6IMvKyeWL2K5UAlyp6WonmB8m7Jd0Hn" crossorigin="anonymous">
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/katex@0.15.2/dist/katex.min.css" integrity="sha384-RZU/ijkSsFbcmivfdRBQDtwuwVqK7GMOw6IMvKyeWL2K5UAlyp6WonmB8m7Jd0Hn" crossorigin="anonymous">
```
</Note>

Expand Down
6 changes: 3 additions & 3 deletions docs/guides/syntax-highlighting.server.mdx
Expand Up @@ -5,7 +5,7 @@ export const info = {
{name: 'Titus Wormer', github: 'wooorm', twitter: 'wooorm'}
],
published: new Date('2021-10-06'),
modified: new Date('2021-11-01')
modified: new Date('2022-02-01')
}

# Syntax highlighting
Expand Down Expand Up @@ -67,14 +67,14 @@ async function main(code) {
For example, to get GitHub Dark from cdnjs:

```html
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.2.0/styles/github-dark.min.css">
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.4.0/styles/github-dark.min.css">
```

If you chose `@mapbox/rehype-prism`, include something like this instead to
get Prism Dark:

```html
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/prism/1.25.0/themes/prism-dark.min.css">
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/prism/1.26.0/themes/prism-dark.min.css">
```
</Note>

Expand Down

1 comment on commit adc64ec

@vercel
Copy link

@vercel vercel bot commented on adc64ec Feb 1, 2022

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Successfully deployed to the following URLs:

Please sign in to comment.