Closed Alan3344 closed 11 months ago
Before enabling a formatter like Prettier, you have to rename the extension .md
of all Markdown documents using import
, export
, or JSX components to .mdx
.
rg "import[ {].* from|export const" -g "*.md" -l
rg
is ripgrep. You can pipe this to a renaming command.
These files must be renamed:
src/pages/gallery.md
docs/tutorials/python-calculator.md
docs/introduction.md
docs/guides/python/testing-on-ios.md
docs/guides/python/testing-on-android.md
docs/guides/python/deploying-web-app/overview.md
docs/guides/python/deploying-web-app/hosting-providers/overview.md
docs/controls/windowdragarea.md
docs/controls/view.md
docs/controls/verticaldivider.md
docs/controls/textfield.md
docs/controls/textbutton.md
docs/controls/tabs.md
docs/controls/switch.md
docs/controls/stack.md
docs/controls/snackbar.md
docs/controls/slider.md
docs/controls/shadermask.md
docs/controls/semantics.md
docs/controls/row.md
docs/controls/responsiverow.md
docs/controls/radio.md
docs/controls/progressring.md
docs/controls/progressbar.md
docs/controls/popupmenubutton.md
docs/controls/page.md
docs/controls/overview.md
docs/controls/outlinedbutton.md
docs/controls/navigationrail.md
docs/controls/markdown.md
docs/controls/listview.md
docs/controls/listtile.md
docs/controls/image.md
docs/controls/iconbutton.md
docs/controls/icon.md
docs/controls/gridview.md
docs/controls/gesturedetector.md
docs/controls/floatingactionbutton.md
docs/controls/filledtonalbutton.md
docs/controls/filledbutton.md
docs/controls/filepicker.md
docs/controls/elevatedbutton.md
docs/controls/dropdown.md
docs/controls/dragtarget.md
docs/controls/draggable.md
docs/controls/divider.md
docs/controls/container.md
docs/controls/column.md
docs/controls/circleavatar.md
docs/controls/checkbox.md
docs/controls/card.md
docs/controls/buttons.md
docs/controls/banner.md
docs/controls/audio.md
docs/controls/appbar.md
docs/controls/animatedswitcher.md
docs/controls/alertdialog.md
blog/2022-09-27-user-authentication.md
rg "import[ {].* from|export const" -g "*.md" -l
rg
是ripgrep。您可以将其通过管道传递给重命名命令。这些文件必须重命名:
src/pages/gallery.md docs/tutorials/python-calculator.md docs/introduction.md docs/guides/python/testing-on-ios.md docs/guides/python/testing-on-android.md docs/guides/python/deploying-web-app/overview.md docs/guides/python/deploying-web-app/hosting-providers/overview.md docs/controls/windowdragarea.md docs/controls/view.md docs/controls/verticaldivider.md docs/controls/textfield.md docs/controls/textbutton.md docs/controls/tabs.md docs/controls/switch.md docs/controls/stack.md docs/controls/snackbar.md docs/controls/slider.md docs/controls/shadermask.md docs/controls/semantics.md docs/controls/row.md docs/controls/responsiverow.md docs/controls/radio.md docs/controls/progressring.md docs/controls/progressbar.md docs/controls/popupmenubutton.md docs/controls/page.md docs/controls/overview.md docs/controls/outlinedbutton.md docs/controls/navigationrail.md docs/controls/markdown.md docs/controls/listview.md docs/controls/listtile.md docs/controls/image.md docs/controls/iconbutton.md docs/controls/icon.md docs/controls/gridview.md docs/controls/gesturedetector.md docs/controls/floatingactionbutton.md docs/controls/filledtonalbutton.md docs/controls/filledbutton.md docs/controls/filepicker.md docs/controls/elevatedbutton.md docs/controls/dropdown.md docs/controls/dragtarget.md docs/controls/draggable.md docs/controls/divider.md docs/controls/container.md docs/controls/column.md docs/controls/circleavatar.md docs/controls/checkbox.md docs/controls/card.md docs/controls/buttons.md docs/controls/banner.md docs/controls/audio.md docs/controls/appbar.md docs/controls/animatedswitcher.md docs/controls/alertdialog.md blog/2022-09-27-user-authentication.md
First of all thank you
Ok, since there were only one or two files containing export/components
that needed to be changed, I did this
There are many "plain" Markdown files that only contains JS's import
.
They must be renamed to .mdx
, too.
有许多“普通”Markdown 文件仅包含 JS 的
import
. 它们也必须重命名为.mdx
。
To maintain compatibility, yes
It seems that using .mdx
does not solve the problem. Is it a previous misunderstanding?
I downloaded the plug-in and can parse this document normally, but docusaurus.io
still has parsing errors.
It doesn’t seem to be a formatting issue.
Also I tried updating all packages
Currently, you can only use the .md
suffix, and no error will be reported. If there is an extra blank line in the format, use an ordinary text editor to delete it, and then save it for use.
Also I tried updating all packages
You should add minimal packages (e.g. Prettier) and keep all the package versions until you confirm Prettier works with all renamed-to-.mdx
documents.
Upgrade should be an independent PR.
Also I tried updating all packages
You should add minimal packages (e.g. Prettier) and keep all the package versions until you confirm Prettier works with all renamed-to-
.mdx
documents. Upgrade should be an independent PR.
Oh, I'm just testing the upgrade locally and don't intend to PR the version of the project's package.
You may have upgraded the major version of MDX-related packages from 1 to 2, but this must not be done. MDX 1 & 2 have different syntax. https://mdxjs.com/blog/v2/
Only MDX2 can embed JS expressions into { ... }
, which might cause the syntax error in your screenshot.
You may have upgraded the major version of MDX-related packages from 1 to 2, but this must not be done. MDX 1 & 2 have different syntax. https://mdxjs.com/blog/v2/
Only MDX2 can embed JS expressions into
{ ... }
, which might cause the syntax error in your screenshot.
Thank you🙏, I'll try it
I found these two lines of relevant information:
├─ @mdx-js/mdx@1.6.22
├─ @mdx-js/react@1.6.22
1.6 is compatible with Docusaurus 2.x and doesn't have a problem.
If you want to upgrade only Docusaurus-related packages, the instruction is available once you do yarn start
.
You can choose what you will upgrade by yarn upgrade-interactive
.
The unchanged code has forced line breaks and there are issues with trailing commas and semicolons. Once I format it, the code files themselves that have not changed will also be modified due to formatting issues. They cannot be merged directly, conflicts will occur and need to be done manually. Adjustment, this is very troublesome. At first glance, it seems to be a format problem. This is the default configuration of the vscode plug-in
For
*.js