519 questions
Best practices
0
votes
4
replies
80
views
Can I prevent my docusaurus website going offline during the build process?
Currently, my website builds on pushes to main using GitHub Actions. The GA takes about 3 minutes, during which the website is 404.
My experience of other website builders (Jekyll, WP, whatever) is ...
3
votes
1
answer
175
views
"Next" pagination button shows English category title instead of translated label
I am using Docusaurus (v3) with i18n enabled (English as default, Russian as a second language).
I have a documentation category configured to use a generated-index. I have successfully translated the ...
1
vote
0
answers
93
views
Docsearch Typesense scraper only finds records on Docusaurus landing page
Problem
I’m using Docusaurus with Typesense and the docsearch-typesense-scraper to index my documentation site.
Everything runs fine — the sitemap is found, and the scraper produces records.
However, ...
0
votes
0
answers
108
views
How to show a single version dropdown per product in Docusaurus multi-product documentation?
I’m building documentation for multiple products on a single Docusaurus 3 website. Each product has its own versions, and I want users to be able to select a product first, then optionally select a ...
0
votes
0
answers
59
views
Docusaurus url breaks build when using process.env
I have two subdomains for my Docusaurus site:
https://test.mydomain.com
https://docs.mydomain.com
In my docusaurus.config.js, I tried setting the url using an environment variable:
const config = {
// ...
0
votes
0
answers
66
views
Add index.html suffix to docusaurus openapi generated files
When building a docusaurus site its index.html hrefs are https://localhost:3000/integrations/docs and I would like it to be https://localhost:3000/integrations/docs/index.html, because I'm using its ...
0
votes
0
answers
67
views
Automatically generate sidebar docusaurus
Question
Description
I created two sidebars: one for the docs directory and another for the docs/cs directory. Inside the cs directory, there's a README.md file and a leetcode/README.md file. The ...
0
votes
2
answers
185
views
How can I force docusaurus to do a hard navigation for a link in the navbar
I'm embedding my docusaurus site within a bigger Next.js project. When a user clicks on the title link in the navbar, docusaurus does a soft, client-side navigation to its home page. This is NOT what ...
0
votes
1
answer
118
views
Making docusaurus RTL
I'm having trouble making docusaurus RTL. I used a solution that changed the CSS by the following:
html {
direction: rtl;
font-family: 'Vazir', 'Tahoma', 'Arial', sans-serif;
}
/* Optionally, ...
0
votes
0
answers
239
views
How can I automatically add numbered headings to heading elements in Docusaurus?
I'm using Docusaurus v3 to build documentation for my QMS, and I want to automatically add hierarchical numbering to headings, like this:
# 1. Introduction
## 1.1 Overview
### 1.1.1 Details
I want to ...
0
votes
0
answers
81
views
Github Pages @easyops-cn/docusaurus-search-local duplicates url
I have a docusaurus site hosted on a custom domain on github pages. When I run the site locally the search works properly through the docs. When I am on the custom domain the search returns a ...
0
votes
0
answers
131
views
Docusaurus: Base URL not working with pm2 serve
I am using the Docusaurus app (version: 3.4.0) to render the documents in my other React app.
In my React app, I am rendering Docusaurus via iframe, both my React app and Docusaurus app are deployed ...
0
votes
0
answers
111
views
Docusaurus Java Syntax Highlighting Not Working
I have a Docusaurus project where I am trying to add support for Java syntax highlighting however, despite following the Docusaurus documentation, I was unable to get it to work.
So far I have tried ...
0
votes
1
answer
116
views
How can I apply Docusaurus theme to HTML tags in custom component
I have created a simple custom component to display an HTML details element with a predefined summary:
export default function Solution({children}) {
return (
<details>
&...
1
vote
1
answer
59
views
Prevent Pandoc from generating autolinks in Markdown [closed]
I'm converting docx to Markdown using Pandoc.
Some links are converted to Markdown autolinks. I would like switch off the autolinks generation in Pandoc, but did not find a way to do that.
Background: ...