Skip to content

Commit a23361b

Browse files
committed
Add README.md
1 parent 17e33d6 commit a23361b

File tree

1 file changed

+24
-0
lines changed

1 file changed

+24
-0
lines changed

README.md

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
ObjectBox C and C++ documentation
2+
=================================
3+
This repository contains the sources of the [ObjectBox C and C++ documentation hosted at cpp.objectbox.io](https://cpp.objectbox.io). It is maintained by the ObjectBox team, but everyone can contribute. E.g. if you found a typo, you can fix it here, e.g. by creating a pull request.
4+
5+
Structure
6+
---------
7+
The **text content** is written in the markdown format and the [docs](docs/) folder contains all the mdx files. Our mdx files are mostly standard markdown, just with some mdx components for tabs section (multiple tabs for different languages etc.).
8+
9+
Other resources:
10+
11+
* **Images** are places in the [static/img/assets/](static/img/assets/) folder.
12+
* The **main navigation** is located in the [sidebars.ts](sidebars.ts) file.
13+
* The main **configuration** is done in the [docusaurus.config.ts](docusaurus.config.ts) file.
14+
* CSS styles are written in the [src/css/custom.css](src/css/custom.css) file.
15+
16+
Notes regarding image file names: only use lowercase and no spaces.
17+
18+
Static website generation
19+
-------------------------
20+
The website is built with Docusaurus that transforms the mdx files along with the other files into static HTML files.
21+
22+
Since Docusaurus is a Node.js application, you need to install Node.js and run `npm install` to install all dependencies.
23+
24+
Then, you can run `npm run start` to start the development server and open the website in a browser. You can also run `npm run build` to build the static website.

0 commit comments

Comments
 (0)