Asciidoctor
github-orgmode-tests
Asciidoctor | github-orgmode-tests | |
---|---|---|
34 | 245 | |
4,647 | 147 | |
0.6% | - | |
8.7 | 4.8 | |
about 1 month ago | 5 months ago | |
Ruby | ||
GNU General Public License v3.0 or later | - |
Stars - the number of stars that a project has on GitHub. Growth - month over month growth in stars.
Activity is a relative number indicating how actively a project is being developed. Recent commits have higher weight than older ones.
For example, an activity of 9.0 indicates that a project is amongst the top 10% of the most actively developed projects that we are tracking.
Asciidoctor
-
I don't always use LaTeX, but when I do, I compile to HTML (2013)
You have also AsciiDoctor ( https://asciidoctor.org/ ) which is alive and well. I am using it for technical CS documentation internally, but only for single page documents. I did not try to deploy their whole multi-document setup called Antora ( https://antora.org/ ).
-
[DEV][App Release] Markor 2.11 adds AsciiDoc and CSV Support
AsciiDoc File support. ( #1876, #808, #2022)
-
Good software/SaaS for Technical Documentation CMS
If Maths is important to you, take a look at Asciidoc - https://asciidoctor.org/
-
Documentation generators and custom syntax highlighting
I use Asciidoctor, highlightjs, a custom highlight.js language definition and that bash script:
-
I wish Asciidoc was more popular
AsciiDoc is so close to being good. It slam dunks Markdown, but they just have a few nagging issues that they refuse to fix, for 9 years now:
https://github.com/asciidoctor/asciidoctor/issues/1087
-
Markdown, Asciidoc, or reStructuredText - a tale of docs-as-code
Asciidoctor is a Ruby-based text processor for parsing AsciiDoc into a document model and converting it to HTML5, PDF, EPUB3, and other formats. Built-in converters for HTML5, DocBook5, and man pages are available in Asciidoctor. Asciidoctor has an out-of-the-box default stylesheet and built-in integrations for MathJax (display beautiful math in your browser), highlight.js, Rouge, and Pygments (syntax highlighting), as well as Font Awesome (for icons). Although Asciidoctor is written in Ruby, that does not mean you need to know Ruby to use it. Asciidoctor can be executed on a JVM using AsciidoctorJ or in any JavaScript environment (including the browser) using Asciidoctor.js. You can choose any one of three Asciidoctor processors (Ruby, JavaScript, Java/JVM) and get the same experience. You can also use the Asciidoctor Maven Plugin to convert your Asciidoc documentation using Asciidoctor from an Apache Maven build.
-
Designing Go Libraries: The Talk: The Article
asciidoctor for writing
-
Docs as code vs a tool that can work with .md and xml?
If you're looking at AsciiDoc, you'll want to look at Asciidoctor: https://asciidoctor.org/
- Diving deeper into custom PDF and ePub generation
-
Mau: a lightweight markup language based on Jinja
The third system that I found was AsciiDoc, which started as a Python project, abandoned for a while and eventually resurrected by Dan Allen with Asciidoctor. AsciiDoc has a lot of features and I consider it superior to Markdown, but Asciidoctor is a Ruby program, and this made it difficult for me to use it. In addition, the standard output of Asciidoctor is a nice single HTML page but again customising it is a pain. I eventually created the site of the book using it, but adding my Google Analytics code and a sitemap.xml to the HTML wasn't trivial, not to mention customising the look of elements such as admonitions.
github-orgmode-tests
-
Ask HN: Has Anyone Trained a personal LLM using their personal notes?
- or to visualize and use it as a personal partner.
There's already a ton of open-source UIs such as Chatbot-ui[3] and Reor[4]. And that's just the tip of the iceberg.
Personally, I haven't been consistent enough through the years in note-taking.
So, I'm really curious to learn more about those of you who were and implemented such pipelines.
I'm sure there's a ton of really fascinating experiences.
[1] https://orgmode.org/
- Org Mode
-
From Doom to Vanilla Emacs
literate config (using ORG mode)
-
My productivity app is a never-ending .txt file
Obligatory reference to Emacs Org-Mode [1].
Author's approach is basically Org-Mode with fewer helpers.
Org-mode's power is that, at core, it's just a text file, with gradual augmentation.
Then again, Org-Mode is a tool you must install, accessible through a limited list of clients (Emacs obviously, but also VSCode), and the power of OP's approach is that it requires no external tools.
[1] https://orgmode.org
-
Show HN: Heynote – A Dedicated Scratchpad for Developers
This reminds me a lot of [Org Mode](https://orgmode.org/). Do you have plans to add other org-like features, like evaluating code blocks? I don't personally see myself moving away from org-mode, but it would be nice to have something to recommend to people who are reluctant to use emacs, even if it's only for a single application.
-
How to combine daily journal with general database of people, places, things, etc.
If you want to spare a couple of detours, you probably could start with Emacs Org-mode according to Greenspun's eleventh rule: "Any sufficiently complicated PIM or note-taking program contains an ad hoc, informally specified, bug-ridden, slow implementation of half of Org mode."
- github-orgmode-tests: This is a test project where you can explore how github interprets Org-mode files
-
Ask HN: Local Wysiwyg HTML Editor for Mac
Wow, no one has recommended Org mode (https://orgmode.org). I started using Emacs nearly 20 years ago specifically because of Org. I use Org for all my static sites, note taking, to-do lists and calendar. Org has a lightweight markup language that has far more features than Markdown (e.g., plain text spreadsheets!), but the markup isn't visible to the extent that Markdown is in most editors. Emacs with Org files behaves almost like a WYSIWYG editor. For example, links in Org files are clickable and their URLs aren't visible unless a cursor is hovered over them. I'm an obsessive note-taker with more than 6,000 Org files in my personal knowledge base and none of the dozens of other note-taking apps that I've evaluated comes even close to Emacs with Org. But to be fair, I create content on Linux only so support for mobile devices doesn't matter to me.
By the way, I think it's hilarious that you mentioned Dreamweaver, dv35z, because I experimented with using Dreamweaver for note-taking in the 90s! I still have a few HTML files that include notes I took back then using Dreamweaver. Needless to say, I definitely prefer Emacs with Org!
-
Think in Analog, Capture in Digital
Just another reason for one to get into org-mode[1] and org-roam[2].
Combine this with the concept of Zettelkasten[3] and you have a wonderful way to organize and store all your notes and writings, and even a way to know at what point you should move your idea from analog to digital (based on it's maturity, e.g. "evergreen state").
1. https://orgmode.org/
- Welche Note taking/Wiki App nutzt ihr, falls überhaupt?
What are some alternatives?
RDoc - RDoc produces HTML and online documentation for Ruby projects.
logseq - A local-first, non-linear, outliner notebook for organizing and sharing your personal knowledge base. Use it to organize your todo list, to write your journals, or to record your unique life.
Zettlr - Your One-Stop Publication Workbench
org-roam-ui - A graphical frontend for exploring your org-roam Zettelkasten
plantuml - Generate diagrams from textual description
todo.txt-cli - ☑️ A simple and extensible shell script for managing your todo.txt file.
ansible-doc-generator - CLI for documenting Ansible roles into Markdown files.
marktext - 📝A simple and elegant markdown editor, available for Linux, macOS and Windows.
GitHub Changelog Generator - Automatically generate change log from your tags, issues, labels and pull requests on GitHub.
Joplin - Joplin - the secure note taking and to-do app with synchronisation capabilities for Windows, macOS, Linux, Android and iOS.
hugo-PaperMod - A fast, clean, responsive Hugo theme.
pandoc - Universal markup converter