Skip to content

Commit 4663e6d

Browse files
committed
website update
1 parent f249e89 commit 4663e6d

1 file changed

Lines changed: 7 additions & 7 deletions

File tree

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,36 +1,36 @@
11
{/* ------------------------------------------------------------------------ */}
22

3-
[Doxygen](https://doxygen.nl) is the industry standard for generating API documentation from annotated C/C++ source code.
3+
[Doxygen](https://doxygen.nl) is the **industry standard** for generating API documentation from annotated **C/C++** source code.
44

5-
[Docusaurus](https://docusaurus.io) is a modern documentation website generator that provides a clean, responsive, and user-friendly interface for creating documentation sites.
5+
[Docusaurus](https://docusaurus.io) is a **modern documentation website generator** that provides a clean, responsive, and user-friendly interface for creating documentation sites.
66

7-
**doxygen2docusaurus** is a command-line tool that bridges the gap between Doxygen-generated API documentation and modern Docusaurus websites. It converts Doxygen XML output into CommonMark files optimised for Docusaurus, enabling seamless integration of comprehensive API reference documentation within project documentation sites.
7+
**doxygen2docusaurus** is a command-line tool that bridges the gap between Doxygen-generated API documentation and modern Docusaurus websites. It **converts Doxygen XML** output into **CommonMark** files optimised for Docusaurus, enabling **seamless integration** of comprehensive API reference documentation within project documentation sites.
88

99
## Features & Benefits
1010

1111
### High quality documentation pages
1212

13-
The tool leverages Docusaurus's clean, modern interface to create visually appealing and professional-looking documentation pages.
13+
The tool leverages Docusaurus's **clean**, **modern interface** to create visually appealing and **professional-looking documentation pages**.
1414

1515
![doxygen2docusaurus function](/assets/images/function.png)
1616

1717
### Enhanced navigation experience
1818

19-
To improve the user navigation experience, for each reference sub-site, the tool generates a dropdown menu for the top navigation bar and a sidebar. For each page, it also creates the headers necessary for the table of contents.
19+
To improve the user navigation experience, for each reference sub-site, the tool generates a **dropdown menu** for the top navigation bar and a **sidebar**. For each page, it also creates the headers necessary for the **table of contents**.
2020

2121
![doxygen2docusaurus navigation](/assets/images/navigation.png)
2222

2323
### Flexible topic-based structure
2424

25-
The tool enables grouping of API reference documentation by topics, which can be customised to suit project requirements. This feature enhances the organisation of documentation, making it easier for users to locate relevant information. Each topic page is organised into clear sections, with comprehensive indices for all sections displayed at the beginning of the page for quick navigation.
25+
Doxygen enables **grouping of API reference documentation by topics**, and **doxygen2docusaurus** prioritises rendering these topic pages with enhanced structural organisation. This functionality improves documentation accessibility, facilitating efficient information retrieval. Each topic page is systematically organised into distinct sections, with comprehensive indices presented at the beginning of each page to enable rapid navigation.
2626

2727
![doxygen2docusaurus topics](/assets/images/topics.png)
2828

2929
### Streamlined documentation workflow
3030

3131
**doxygen2docusaurus** is a versatile CLI application that can be employed in virtually any scenario, from manual invocation to automated CI/CD environments, with the generated pages either forming part of the repository or being created dynamically during website publishing.
3232

33-
However, the recommended approach is to execute the tool on the development machine where the website is maintained, allowing the resulting CommonMark files to be seamlessly integrated into existing Docusaurus sites and stored within the project repository.
33+
However, the recommended approach is to **execute the tool on the development machine** where the website is maintained, allowing the resulting CommonMark files to be seamlessly integrated into existing Docusaurus sites and **stored within the project repository**.
3434

3535
Whilst this approach requires additional repository space, the significant advantage lies in enabling straightforward tracking of documentation changes.
3636

0 commit comments

Comments
 (0)