Unterstützung für das AsciiDoc-Format zum Schreiben von Beiträgen

Gibt es eine Möglichkeit, Beiträge im AsciiDoc-Format zuzulassen?

AsciiDoc ist eine leichtgewichtige Auszeichnungssprache, ähnlich wie Markdown. Wir verwenden AsciiDoc zum Schreiben und Antora zum Rendern von Dokumentationsseiten. Derzeit verwenden wir Discourse als unsere Community.

Die Community und die Dokumentationsseite können einige gemeinsame Informationen/Kenntnisse austauschen. Es besteht die Notwendigkeit, einige Dokumentationsinhalte in die Community zu migrieren.

4 „Gefällt mir“

Willkommen, Stephen :slight_smile:

Derzeit gibt es keine Möglichkeit, Beiträge im AsciiDoc-Format zu schreiben.
Ich glaube, es wäre ein Plugin erforderlich, und ich vermute, es wäre schwierig zu implementieren, wenn es mit der regulären Verwendung von Markdown-it, das Discourse verwendet, in Konflikt gerät. Ich bin jedoch kein Entwickler.

Können Sie näher erläutern, was Sie damit meinen? Ich bin mir nicht sicher, ob ich das verstehe.

1 „Gefällt mir“

Solange es in Inseln implementiert wurde, wäre der Bau eines Plugins dafür nicht allzu schwer. Ich würde schätzen, dass der Bau etwa eine Woche Arbeit in Anspruch nehmen würde, mehr oder weniger z. B.:

```asciidoc
DEIN ASCIIDOC HIER
```

Die Antora-Integration und die Veröffentlichung würden eine ziemliche Komplexität hinzufügen und dies möglicherweise in mehrere Arbeitswochen verschieben.

2 „Gefällt mir“

Ooh. Wir verwenden auch Antora. Das wäre toll!

Ja. Ein Plugin wäre schön. Da unsere Beiträge viele Tabellen benötigen könnten, womit Markdown nicht gut zurechtkommt. Außerdem müssen einige Beiträge möglicherweise in andere Sprachen übersetzt werden, und nach der Übersetzung ist das Format ein Chaos.

Ich freue mich zu hören, dass es nicht schwer ist, ein solches Plugin zu entwickeln. Könnten Sie bitte einige Anleitungen oder ein Tutorial zur Entwicklung teilen? Dann kann ich unsere Ingenieure bitten, es zu entwickeln.

Haben Sie die svgbob-Komponente gesehen?