Skip to content
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

Add AsciiDoc support #77

Open
jklizarraga opened this issue Nov 5, 2024 · 1 comment
Open

Add AsciiDoc support #77

jklizarraga opened this issue Nov 5, 2024 · 1 comment
Labels
enhancement New feature or request vscode The issue is related to our VS Code extension

Comments

@jklizarraga
Copy link

I am pretty frustrated with standard document workflows involving PDF and MS Word.

It would be beyond amazing to be able to work in a documents-as-code fashion using AsciiDoc + SemanticDiff + MergeBoard, especially now that AsciiDoc is being standardised under the Eclipse Foundation.

This use case has a potential market that goes beyond coding and programmers, but any organisation or individual working with documents.

I hope it is feasible and not too difficult to implement; there are already parsers that produce the AST of an AsciiDoc file.

@jklizarraga jklizarraga added enhancement New feature or request vscode The issue is related to our VS Code extension labels Nov 5, 2024
@mmueller2012
Copy link
Contributor

An AST is technically not sufficient for adding support for a new language / file format in SemanticDiff. ASTs often store information in an abstract format (e.g. a boolean to indicate whether a function is async) and don't expose which token in the text leads to this interpretation. We therefore work with Concrete Syntax Trees (CST), which have a 1:1 mapping for each input token to a corresponding node in the tree.

I glanced over the linked parser and it seems that it uses an AST and stores the location information only on a line-number granularity. This would not be sufficient for SemanticDiff. We would probably need a different parser to add support.

This use case has a potential market that goes beyond coding and programmers, but any organisation or individual working with documents.

They probably won't use VS Code or a GitHub App and we would need to provide a completely different frontend for such an audience 😉️.

Just out of curiosity, what is your use case for AsciiDoc?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request vscode The issue is related to our VS Code extension
Projects
None yet
Development

No branches or pull requests

2 participants