conlang.phundrak.com/README.org

71 lines
2.9 KiB
Org Mode
Raw Normal View History

2023-02-26 18:20:43 +00:00
#+title: Pundraks Conlangs
2023-03-22 10:04:20 +00:00
#+html: <a href="https://www.gnu.org/software/emacs/"><img src="https://img.shields.io/badge/Emacs-30.0.50-blueviolet.svg?style=flat-square&logo=GNU%20Emacs&logoColor=white" /></a>
2023-03-22 10:06:20 +00:00
#+html: <a href="https://orgmode.org/"><img src="https://img.shields.io/badge/Written%20with-Org%20mode-success?logo=Org&logoColor=white&style=flat-square"/></a>
2023-02-26 18:20:43 +00:00
#+html: <a href="https://v2.vuepress.vuejs.org/"><img src="https://img.shields.io/badge/Framework-Vuepress-42D392?logo=Vue.js&logoColor=white&style=flat-square"/></a>
2023-03-22 10:04:20 +00:00
#+html: <a href="https://conlang.phundrak.com"><img src="https://img.shields.io/badge/dynamic/json?label=Website&query=%24%5B%3A1%5D.status&url=https%3A%2F%2Fdrone.phundrak.com%2Fapi%2Frepos%2Fphundrak%2Fconlang.phundrak.com%2Fbuilds&style=flat-square&logo=buffer" /></a>
2023-02-26 18:20:43 +00:00
* About the Project
This repository holds my conlanging projects I am working on. The
files Im using are written in [[https://orgmode.org/][org-mode]] and are exported in Markdown
through [[https://www.gnu.org/software/emacs/][Emacs]].
These Markdown files are then compiled by [[https://v2.vuepress.vuejs.org/][Vuepress]] into a beautiful
2023-02-26 20:21:34 +00:00
website available at [[https://conlang.phundrak.com][conlang.phundrak.com]].
2023-02-26 18:20:43 +00:00
* Running the project
In order to run the project, you need to export all =.org= files in the
Markdown format. To do that easily, you can use an org project setup
in Emacs, mine looks like this:
#+begin_src emacs-lisp
(require 'ox-gfm)
(defvar phundrak--projects-conlanging-common-root
"~/org/conlanging/docs/"
"Points to the common root of my source and target for my
conlang.phundrak.com org project.")
(setq org-publish-project-alist
`(("conlang-phundrak-com-md"
:base-directory ,phundrak--projects-conlanging-common-root
:base-extension "org"
:exclude ,(rx (* print
(or "CONTRIB"
"README"
"site-map"
"temp"
"private"
"svg-ink")
(* print)))
:publishing-directory ,phundrak--projects-conlanging-common-root
:recursive t
:language "en"
:publishing-function org-gfm-publish-to-gfm
:headline-levels 5
:auto-sitemap nil
:auto-preamble nil)
("conlang-phundrak-com"
:components ("conlang-phundrak-com-md"))))
#+end_src
Once you have all the Markdown files generated correctly, you can
install the dependencies of the project.
#+begin_src shell
yarn
# or
2023-02-26 20:18:22 +00:00
npm install # delete the yarn.lock file first
2023-02-26 18:20:43 +00:00
#+end_src
Once this is done, you can launch a preview of the project.
#+begin_src shell
yarn docs:dev
# or
npm run docs:dev
#+end_src
You can also compile the project to a static website.
#+begin_src shell
yarn docs:build
# or
npm run docs:build
#+end_src