-
-
Notifications
You must be signed in to change notification settings - Fork 3.3k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
[new feature] SCDOC format #10065
Comments
I guess my questions would be:
|
Seven years since the first commit, a4193949ec755b3848a803a9b02364eeddbb1455 at scdoc git.
Most recent commit from 6 months.
I believe many projects from Sourcehut use it.
Hum, let me explain. There is a project, say Cardboard, that is using Pandoc to convert a Markdown file to a manpage. Pandoc is awesome for converting Markdown to manpage, it goes without saying. On the other hand, scdoc is crafted to be, according to its creator, "a man page generator that had no more dependencies than man itself". So, the idea here is:
|
Thanks. Note: if you just want a lightweight, no dependency man page generator that uses markdown (commonmark) source, |
In your first comment you seem to want to use scdoc as an input format; in your reply, you talk of using pandoc to produce scdoc which would then be processed by The format seems straightforward and fairly simple, if underspecified. (e.g. how much indent is required for a sublist? Can you include multiple paragraphs under list items, and if so how? if you can't, then what would a pandoc writer do with a list item containing multiple paragraphs?) |
From what I read, indents are hard tabs (no 4 spaces). I have noticed this style in many scdoc pages.
Following the indentation, I suppose:
|
Have you tried it, though? |
To be honest I did not test this. A truckload of things were in my way this week. Here is a quick test I did: |
SCDOC git repo at sourcehut is a document format similar to Markdown, primarily used to be converted to manpages.
Describe your proposed improvement and the problem it solves.
Add
scdoc
format, as described at https://git.sr.ht/~sircmpwn/scdoc/tree/master/item/scdoc.5.scdDescribe alternatives you've considered.
None. The idea is, precisely, add it as an input that Pandoc can recognize and work with
The text was updated successfully, but these errors were encountered: