Skip to content

Commit dd1e2a3

Browse files
Update readme
1 parent f533608 commit dd1e2a3

File tree

2 files changed

+27
-41
lines changed

2 files changed

+27
-41
lines changed

README.md

-41
This file was deleted.

README.org

+27
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,27 @@
1+
* Nvim Orgmode Docs
2+
3+
Online documentation for [[https://github.com/nvim-orgmode/orgmode][nvim-orgmode]] plugin,
4+
automatically built from the [[https://github.com/nvim-orgmode/orgmode/tree/master/docs][docs]] folder in the [[https://github.com/nvim-orgmode/orgmode][nvim-orgmode]] repository.
5+
6+
**** DO NOT submit PRs to this repository. All changes to the documentation should be made in the [[https://github.com/nvim-orgmode/orgmode/tree/master/docs][nvim-orgmode docs]] folder.
7+
8+
-----
9+
10+
*** View this documentation locally
11+
12+
**** Dependencies
13+
1. [[https://nodejs.org/][nodejs]] - Version 18 or later
14+
2. [[https://pandoc.org/][pandoc]] - Version 3.5 or later
15+
16+
**** How to run
17+
1. Run =npm install= to install the dependencies.
18+
2. Run =npm run docs:dev= to start the development server.
19+
20+
**** How it works
21+
Publishing documentation to the Github pages follows a multi-step process:
22+
1. Once =docs= are updated in the[[https://github.com/nvim-orgmode/orgmode][ nvim-orgmode]] repository,
23+
[[https://github.com/nvim-orgmode/orgmode/blob/master/.github/workflows/web_docs.yml][workflow]] runs to push the =docs= folder to this repository
24+
2. Once the =docs= folder is up to date, another [[https://github.com/nvim-orgmode/nvim-orgmode.github.io/blob/main/.github/workflows/deploy.yml][workflow]] runs, which does these steps:
25+
1. Converts =org= files to =markdown= files with =pandoc=
26+
2. Builds the =vitepress= site from the =markdown= files
27+
3. Pushes the =vitepress= site to the =gh-pages= branch

0 commit comments

Comments
 (0)