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? |
|
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. |
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. |
|
(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. |
|
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. |
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 |
|
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? |
|
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? |
|
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) |
|
Hi, thanks for the great tutorial. At "Deploy from command line" section of the "Deployment" page, I needed to use |
|
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? |














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.
All reactions