Nólëbase Integrations
A collection of diverse documentation engineering tools.
Nólëbase is an open-source knowledge base named after Nólëbase, pronounced as nole-base, derived from the Quenya word 'nólë' meaning 'knowledge' and the English word 'base', hence 'knowledge base'.
- 🚀 Documentation Engineering First
- From the perspective of documentation engineering, solve and simplify some UX/DX problems, aiming to let creators focus on writing documents, notes, making cards and GTD!
- ⚖️ Compatible and Easy to Use
- Whether it is static-first like VitePress, or client-first like Obsidian, the "Nólëbase Integrations" project hopes to provide a similar or even better experience across different platforms.
- 🧩 Rich Features
- Each platform has its own advantages and missing features, but the documentation engineering is already time-consuming and labor-intensive. These issues should not be obstacles to restrict the writing and sharing of documents and knowledge. Expand your imagination far beyond with Nólëbase Integrations.
- Documentation: It's not easy to demonstrate how integrations work with VitePress, and navigate to find references in README, why don't we give it a try to use our documentation site generated by VitePress?
- packages directory: All the integrations are kept under the
packagesdirectory, and each integration is a separate package. You can find the corresponding README in each package directory for more details.
If you just want to use the integrations, you can use the following command to install the integrations you need into your VitePress project:
pnpm i @nolebase/<integration-name> -DIf you use @antfu/ni, you can also use the following command:
ni @nolebase/<integration-name> -DTo find out the integration name, there is a list of integrations below.
- Bi-Directional Links (for
markdown-it) - Elements Transformation (for
markdown-it) - Enhanced Readabilities (for VitePress)
- Inline Link Previewing (for VitePress)
- Blinking highlight targeted heading (for VitePress)
The project uses unbuild and vite to develop and build. With the powerful features offered from jiti, we no longer need to use Rollup for tedious configuration and then watch the local file changes and bundle the modified and developed the modules without vite for hot-reload. We can directly run the following command to output the bundled file and get started on development:
pnpm run packages:stubIf you use @antfu/ni, you can also use the following command:
nr packages:stubNext, you need to start the the documentation site (with VitePress) for previewing and development. You can use the following command:
pnpm run docs:devIf you use @antfu/ni, you can also use the following command:
nr docs:devpnpm run packages:buildIf you use @antfu/ni, you can also use the following command:
nr packages:buildTo build the documentation and preview site, you can use the following command:
pnpm run docs:buildIf you use @antfu/ni, you can also use the following command:
nr docs:build
