Replies: 15 comments 46 replies
-
To be honest, I've been having a lousy time trying to figure out to get http://localhost:3000 working on my Mac. How necessary is activating a local web server for this tutorial and for Docusaurus as a whole? If it's absolutely essential, can that step be added to the list of requirements alongside Node and Yarn? |
Beta Was this translation helpful? Give feedback.
-
I just ran the command npx @docusaurus/init@latest init my-website classic to start my Docusaurus project and after running yarn run start two of the links on http://localhost:3000/docs/tutorial-basics/congratulations are already broken. I did not change the code at all. Is this a known problem? Pictures are attached and I am quite confused. |
Beta Was this translation helpful? Give feedback.
This comment has been hidden.
This comment has been hidden.
-
The tutorial is amazing and quick! One thing I noticed is that when I tried the versioning portion of the tutorial, I saw this error message on the docs page after I ran
Here's a Loom which walks through the issue. |
Beta Was this translation helpful? Give feedback.
-
(base) paul@paulpauldeMacBook-Pro my-website % npm run build
[INFO] [en] Creating an optimized production build... ✔ Client ✖ Server [ERROR] Docusaurus server-side rendering could not render static page with path /foo/bar/bar. Error: Minified React error #130; visit https://reactjs.org/docs/error-decoder.html?invariant=130&args[]=object&args[]= for the full message or use the non-minified dev environment for full errors and additional helpful warnings. |
Beta Was this translation helpful? Give feedback.
-
The tutorial cannot be edited. If I click the Edit button, it reports 404. |
Beta Was this translation helpful? Give feedback.
-
Hello, great tutorial 🙌 Little feedback on the configure-the-sidebar part of the basic tutorial. When editing the Editing the Or even copy / pasting the exact code from the doc (everything else from the original file is commented out) I would assume I am supposed to see a sidebar. |
Beta Was this translation helpful? Give feedback.
-
No mention of site config / themeConfigOur tutorial doesn't currently show some basic things such as explaining the site config file, and in particular I guess we should add a step at the end of the basic tutorial to at least show the user how to add navbar/footer items? As a temporary workaround, I mentioned those in #8032 |
Beta Was this translation helpful? Give feedback.
-
Beta Was this translation helpful? Give feedback.
-
Hi. I can't find out anything in the tutorial about changing the sample code languages (currently it defaults to cURL, Go, Node and Python). Assuming it is possible for a mere mortal to change this via configuration, could this please be included in the documentation? |
Beta Was this translation helpful? Give feedback.
-
Found a bug in one of the pages markdown examples Edit: will be fixed in #9696 |
Beta Was this translation helpful? Give feedback.
-
I'm not sure if I'm the right target audience as I don't know javascript (is it mentioned anywhere that knowing javascript is a prerequisite?), but I got a bit stuck at the translation part (https://github.com/facebook/docusaurus/blob/main/packages/create-docusaurus/templates/shared/docs/tutorial-extras/translate-your-site.md).
But in the used "my-website" project, the config file only has an i18n object within "const config". So it's not clear what I am supposed to do with this snippet, append it to the end of the file? Replace the "export default" part at the end of the file? |
Beta Was this translation helpful? Give feedback.
-
Hi, it's not exactly a bug (more PIBKAS) but FYI, when I first created 2021-02-28-greetings.md in vscode, I mistakenly created it as a folder. Deleting the folder and creating a file didn't then get the md show. Worked as expected after re-serving the site (ctrl-c / npm start) |
Beta Was this translation helpful? Give feedback.
-
Hi, thanks for the great tutorial. At "Deploy from command line" section of the "Deployment" page, I needed to use |
Beta Was this translation helpful? Give feedback.
-
The tutorial is written under the assumption that when the user created their site, they selected JavaScript. If the user selected TypeScript, the user cannot complete all parts of the tutorial, especially the Extras. Moreover, it is extremely hard to find any documentation anywhere that explains how to switch from TypeScript to JavaScript. What's that you say? It's not possible to do that? Then there should be "dead end" documentation that explains that a site cannot be switched from one to the other. Question: Should the prompt for JavaScript over TypeScript really not mention the need to accept the default if one expects to understand Docusaurus in 5 minutes. If this caution already appears somewhere, would you please draw my attention to that location? |
Beta Was this translation helpful? Give feedback.
Uh oh!
There was an error while loading. Please reload this page.
-
Docusaurus tutorial
The Docusaurus tutorial is very important: it is the very first thing a Docusaurus user sees (init template or CodeSandbox)
Please report here if anything does not work or is unclear.
Beta Was this translation helpful? Give feedback.
All reactions