nurkiewicz, to random
@nurkiewicz@fosstodon.org avatar

released IDE for writing... documentation! I'm just surprised it doesn't seem to support out-of-the-box https://www.jetbrains.com/writerside/

lr, to python
@lr@ciberlandia.pt avatar

3️⃣ razões para conhecer o http://pythonfluente.com:

0️⃣ sem “Hello World”: livro intermediário/avançado para dominar 3.10+ e sua biblioteca padrão.

1️⃣ tradução PT-BR da 2ª edição de Fluent Python (O’Reilly 2022) ⭐️⭐️⭐️⭐️⭐️, publicado em 9 idiomas

2️⃣ 💯% grátis CC-BY-ND na Web, HTML: http://pythonfluente.com, fontes: & : https://github.com/pythonfluente/pythonfluente2e

bbatsov, to orgmode
@bbatsov@hachyderm.io avatar

Are you surprised by those results? It seems that and are (way) less popular than I thought, and that is way more popular than I expected.

Of course, we should take those results with a grain of salt, as I assume many of my followers are users. 😀

frankel, to random
@frankel@mastodon.top avatar

Using to write my two books

https://www.yieldcode.blog/post/asciidoc-for-book-writing/

I, for one, am also a happy AsciiDoc and user

oblomov, (edited ) to markdown
@oblomov@sociale.network avatar

For historical reasons, I mostly use for my writing, although I've started to use (through ) more and more these days.

One of the things I is intended to be in a more “playwright” style, so I've been looking around for stuff more focused on (for either theater or screen, I'm not picky at the moment.).

So I came across
https://fountain.io/ which is actually … pretty close to what I was thinking about.

skwee357, to writing
@skwee357@mstdn.social avatar

As some of you know, I can call myself a self-published author.

In my latest blog post, I outline the tools and process I used to write my two books.

https://www.yieldcode.blog/post/asciidoc-for-book-writing/

ambihelical, to typst
@ambihelical@qoto.org avatar

Playing around with it’s like a dream come true so far. I edit in , changes show up in the generated pdf very quickly with the command line tool in watch mode. No fussing around with ponderous toolchains. Next up converting a medium size doc with a lot of equations from .

schalken, to random

Pro-tip to anyone who has to write a document: give / a try.

Writing a course syllabus with the AsciiDoc markup language, I get these benefits:

  • Can write one sentence per line, which helps me with structure and clarity.

  • Trivial to indicate what is a heading and what is body text, which is critical for accessibility and for...

  • Automatic table of contents and section numbering

  • Easy to do basic formatting like italics, but also more complex stuff, like links to specific sections.

  • Works well with version control / diffing software.

  • Comments

  • Can tell what's going on at a glance (e.g., you can tell where hyperlinked text goes just by looking at it)

Using AsciiDoc requires a little more up-front learning than just using Word or whatever, but it's so much simpler in the long run.

Markdown would probably also work, but I think AsciiDoc is the sweet spot between features and simplicity.

giuseppebilotta, to random
@giuseppebilotta@fediscience.org avatar

For anyone who might be interested, I've just tagged v1.0 (and v1.1 ahem) of my tool
https://github.com/Oblomov/asciidoctor-litprog

This is an extension that tangles & weaves your source code & documentation with a single pass from an .adoc document.

It's self-hosted: the README is the module source.

(Obviously, a bootstrap version of the module is included to be able to build the actual module.)

giuseppebilotta,
@giuseppebilotta@fediscience.org avatar

(more >)

Since the input for this module is a standard document, “weaving” isn't strictly necessary (a processor like can output a reasonable approximation of the final HTML without many issues), but we do some transformation to normalize code block titles and add cross reference hyperlinks where appropriate. These cross references now have a default styling that fits better with the default stylesheet used by Asciidoctor.

(more >)

thelastpsion, to markdown
@thelastpsion@bitbang.social avatar

HIVE MIND

Is there a way of getting Pandoc to detect a style or font in a DOCX file?

I'm specifically thinking of in-line preformatted text, so converting (say) a Source Code character style in Word to backticks for or . Or a different paragraph style to a triple-backtick (or [source] for AsciiDoc) block.

Could this be scripted with Pandoc's Lua engine?

Or is there a better tool to do DOCX to AsciiDoc than pandoc?

thelastpsion, to neovim
@thelastpsion@bitbang.social avatar

#NeoVim update. The discovery of registers has made me very happy. Macros are saving me a lot of time!

I'm slowly improving my speed with movements. It's also forcing me to address some bad typing habits of mine.

#AsciiDoc support using vim-asciidoctor is better than the built-in syntax highlighting, but it's still mediocre and breaks. In an ideal world there would be a #Treesitter parser for it, but I don't know if I have the energy/skill to work on that.

Mela, to random German
@Mela@zusammenkunft.net avatar

"Nimm doch Markdown", haben sie gesagt.
"Das ist total einfach", haben sie gesagt.
"Damit arbeitet man ganz flott", haben sie gesagt.
"Das funktioniert in ganz vielen Editoren", haben sie gesagt.

Auch Markdown: Ich brauch wieder eine Kompatibilitätsübersicht wie damals bei Unix. https://www.markdownguide.org/tools/zettlr/

ellcrys, (edited )

@Mela und deswegen mag ich lieber. Zusammen mit (Docs-as-Code) lassen sich so ganze Dokumentationen erstellen und mit kann man das auch in fast beliebige Ausgabeformate umwandeln...
P.S.: und es wird direkt von GitLab unterstützt...

profoundlynerdy, to opensource
@profoundlynerdy@bitbang.social avatar

I'm in the early stages of writing some technical documentation. It's just some notes in right now but I'll probably pivot to before releasing it. I need to simulate an LED display in an : basically a fancy 7 segment plus some small status icons.

I could make each SVG of the display manually, but it seems like I should be able to use a of some sort to accomplish the SVG generation. Has anyone else done something like this

scy, to linux
@scy@chaos.social avatar

Suppose I was thinking about writing ⁠s for the command-line tools I build, but I don’t want to learn a 50 year old typesetting language () to do that.

What are my options? ? What would you use? What do you use?

I looked into Markdown to man conversion, and it seemed to suck.

thelastpsion,
@thelastpsion@bitbang.social avatar

@scy Big fan of here. I'm using it for covering some old technical documentation to something more modern. Markdown just isn't as good.

AstridSawatzky, to random

Is there anywhere a editor for ?
Like we had in the olden days for html.
You type where see the result but you still can edit the underlying pure asciidoc, if wanted.

amolith, to random
@amolith@nixnet.social avatar
amolith,
@amolith@nixnet.social avatar

I am very much in the minority: I dislike Markdown but haven't found anything else I like more that's as easy to work with :akko_woozy:

looks perfect, but asciidoctor is Ruby and Ruby is pain :akko_cry:

thelastpsion, to neovim
@thelastpsion@bitbang.social avatar

HIVE MIND: I'm finally trying . Can you recommend some plugins for me?

For now, I'll be using it for the following:

What makes your NeoVim world happier?

thelastpsion, to random
@thelastpsion@bitbang.social avatar
thelastpsion, to retrocomputing
@thelastpsion@bitbang.social avatar

Earlier today, after some hunting, I found the text version of the Programming Manual that came with the Series 3a. So, while I was sitting in front of the TV this evening, I thought I'd start converting it to .

First chapter is pretty much done.

I think (hope) I've got a paper copy in a box somewhere, so I can compare it to the original.

travisfw, to blogging
@travisfw@fosstodon.org avatar

Is there any or -oriented publishing for writing a larger collection of pages in ?

YesIKnowIT, to random
@YesIKnowIT@mastodon.social avatar

Tired of fighting against a bloated word processor when writing your latest report, novel, technical documentation or blog post?

Maybe that's the sign you're ready to consider using a lightweight markup language...
https://itsfoss.com/asciidoc-guide/


@itsfoss2

theruran, to random
caiocco, to linux Portuguese

A graça de usar umas máquinas mais velhas pra rodar ou algum está na exploração dos limites e tipos de softwares viáveis dentro deles. Programas para modo texto, concentração de atividades em editores (como ), linguagens de marcação para escrever documentos (como e etc. O desafio de montar um ambiente leve, elegante e, ao mesmo tempo, poderoso e muito funcional, é bastante satisfatório.

  • All
  • Subscribed
  • Moderated
  • Favorites
  • JUstTest
  • GTA5RPClips
  • DreamBathrooms
  • khanakhh
  • ngwrru68w68
  • Youngstown
  • magazineikmin
  • mdbf
  • slotface
  • thenastyranch
  • rosin
  • kavyap
  • tacticalgear
  • tester
  • provamag3
  • osvaldo12
  • cubers
  • ethstaker
  • everett
  • Durango
  • InstantRegret
  • normalnudes
  • Leos
  • modclub
  • anitta
  • cisconetworking
  • megavids
  • lostlight
  • All magazines