org-blog-theme-ui-preset v1.0.11
#+TITLE: Orga
#+HTML:
#+BEGIN_QUOTE org-mode with JavaScript #+END_QUOTE
- What Is It
=Orga= is a flexible org-mode syntax parser. It parses org content into AST ([https://en.wikipedia.org/wiki/Abstract_syntax_tree]), then what you can do with it is limited only by your imagination.
- Why
The reason why markdown is so popular is that org-mode is kind of trapped inside of emacs (I am joking, sort of. š). I want to share the awesomeness with the rest of the world. JavaScript runs everywhere nowadays, so, why not.
- What You Can Do with it NOW
- Build a full-featured gatsby blog in seconds, customize it progressively, bits by bits. [https://www.huxiaoxing.com/building-a-website-with-org-mode-files].
- Build a bare-bone gatsby website (for those of you tinkerers), start building your website from raw data.
- Integrate org-mode into any of your JavaScript projects. E.g. a real-time org-mode -> HTML transformer on your website, like [https://orga.js.org].
- What You Can Do Potentially
- emacs-less cli for org-mode
- org-mode desktop app with [https://www.electronjs.org], or a [https://code.visualstudio.com] extension.
- org-mode mobile app with [https://reactnative.dev].
- Compatible Eco-systems
Nobody likes to reinvent wheels more than us programmers. But when you see a pretty solid wheel, it's wise to take advantage of it.
#+BEGIN_QUOTE āļø interface for parsing, inspecting, transforming, and serializing content through syntax trees #+END_QUOTE
The =orga= parser is completely compatible with unified. Which means you get to take advantage of the works of others put into the pipeline. [https://github.com/retextjs/retext], [https://alexjs.com], [https://wooorm.com/write-music/]? etc.
#+BEGIN_QUOTE Build blazing fast, modern apps and websites with React #+END_QUOTE
One of the best static website/app generator out there. Trust me; I have tried a lot. Don't be put off by words like =React= or =JavaScript=. Like it or not, they are taking over the web. orga is deeply integrated with gatsby (via [file:packages/gatsby-transformer-orga/README.md] and [file:packages/gatsby-theme-blorg/README.md]) to create the tools for building powerful websites without much hassle. Also, We can leverage other plugins people build for markdown-based websites. Which is a much richer eco-system, now it's ours too.
- How Does It Work
- [file:packages/orga/README.org]
- [file:packages/orga/src/types.ts]
- [file:examples/example/]
- [https://orgapp.github.io/gatsby-starter-blorg/]
- Documentation [https://orga.js.org].
- Contribute
After you clone the code:
#+begin_src shell
Bootstrap the Project
yarn run bootstrap
Run Unit Tests
yarn test
Play with the Website
cd www yarn run develop #+end_src
If you find any issue, try to reproduce it on [https://orga.js.org], generate a permalink with the button, and attach it to your GitHub issue.