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

Feature Request: Comment all that is not extracted #7

Open
e-gaulue opened this issue May 28, 2021 · 0 comments
Open

Feature Request: Comment all that is not extracted #7

e-gaulue opened this issue May 28, 2021 · 0 comments

Comments

@e-gaulue
Copy link

e-gaulue commented May 28, 2021

First, thanks a lot to share this nice job.

I use your tool to describe a grammar that is in between computing and true language. I managed to do almost everything I needed.

But I want to use it as a documentation. I mean, I want to put classical HTML before and after elements.

As far as I've seen, your tool can extract elements from URL. But it removes the rest. You can make your changes and then regenerate but hence, you have to put all your "documentation" back and it's not easy.

It would be great if we could use special markup in our HTML page to keep the content as comments that would be rendered as HTML by your "view diagram".

I mean:

/!*
<h1> Title 1 </h1>
<p> lorem ipsum....</p>
!*/

Grammar ::= Production*
Production ::= NCName '::=' ( Choice | Link )
NCName ::= [http://www.w3.org/TR/xml-names/#NT-NCName]
Choice ::= SequenceOrDifference ( '|' SequenceOrDifference )*

/!*
<h1> Title 2 </h1>
<p> lorem ipsum....</p>
!*/

...

Would render:

<!--RR-begin Here begin an html zone-->
<h1> Title 1 </h1>
<p> lorem ipsum....</p>
<!--RR-end Here end an html zone-->

Rendering of EBNF

<!--RR-begin Here begin an html zone-->
<h1> Title 2 </h1>
<p> lorem ipsum....</p>
<!--RR-end Here end an html zone-->

...

Which in turns could be again extracted to:

/!*
<h1> Title 1 </h1>
<p> lorem ipsum....</p>
!*/

Grammar ::= Production*
Production ::= NCName '::=' ( Choice | Link )
NCName ::= [http://www.w3.org/TR/xml-names/#NT-NCName]
Choice ::= SequenceOrDifference ( '|' SequenceOrDifference )*

/!*
<h1> Title 2 </h1>
<p> lorem ipsum....</p>
!*/

...

It would be so practical to edit and modify our documentation.

Best regards,

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant