search

mariotoffia / goasciidoc

Document your go code using asciidoc instead of godoc
Apache License 2.0
17 stars 1 forks source link

Join with other developers to submit a more standardized Go-lang implementation #17

Closed diguage closed 4 months ago

diguage commented 8 months ago

Asciidoc is a great markup language. At the same time, Hugo is also a very good static website generation tool. I like Asciidoc and Hugo. Therefore, I am very much looking forward to an implementation in Go language.

I searched for relevant information and found at least three implementations:

  1. bytesparadise/libasciidoc: A Golang library for processing Asciidoc files.
  2. mariotoffia/goasciidoc: Document your go code using asciidoc instead of godoc
  3. shuLhan/asciidoctor-go: [mirror] Native Go module for parsing and converting asciidoc markup language.

Asciidoc is now being standardized by the Eclipse Foundation: AsciiDoc Working Group | The Eclipse Foundation. Perhaps, you can work together to submit a more standards-compliant implementation to this working group.

Thanks again and good luck.

diguage commented 8 months ago

I submitted the issue to https://github.com/bytesparadise/libasciidoc/issues/1113

mariotoffia commented 8 months ago

Hi @diguage and thanks for the link to eclipse. I don't quite follow you:

My little project, only scans a set of golang files (within a module) to extract comments to generate asciidoc documents. I do not process the asciidoc documents at all. This is up to other tools (I use asciidoctor.js to perform this).

In that regard, I'm uncertain what, in your eyes, may I contribute with?

diguage commented 8 months ago

Hi @mariotoffia Sorry, I misunderstood your project: I thought it was a tool for processing AsciiDoc files into HTML, but it was an extract document tool.