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

Headings/titles without closing sequence #86

Open
dumblob opened this issue Nov 14, 2016 · 2 comments
Open

Headings/titles without closing sequence #86

dumblob opened this issue Nov 14, 2016 · 2 comments

Comments

@dumblob
Copy link

dumblob commented Nov 14, 2016

It's been already almost 2 years I came across DocOnce and since then I've realized, that it's kinda easy to convert existing documents from CommonMark to DocOnce (which was actually the primary motivation for #50 ). The only think I didn't manage to convert is my thinking and liking of one particular syntax choice which I consider tedious, unnecessary and cluttering.

Namely the need to end headings/titles with the same sequence of characters as at the beginning. I could not find a technical reason for this decision (each such heading paragraph is anyway already separated with a newline character before and after).

Would it be possible to make these closing sequences of characters optional? I.e. instead of:

===== My Title =====

allow just:

===== My Title
@KGHustad
Copy link
Collaborator

I think we could allow for the trailing =s to be optional.

If you want it fixed soon, feel free to make a pull request.

@dumblob
Copy link
Author

dumblob commented Feb 15, 2017

I'm out of time, but I looked quickly into what everything would be probably affected. These are my observations:

  1. Add mini test (probably one or two with skipped trailing = will be enough).

  2. Add notes to specification & documentation.

  3. Lines probably affected by the change (might change, but therefore the keywords next to them):

    • 921 syntax_check
    • 1583 1585 1597 1797 1896 1898 exercises
    • 2118 2122 2162 extract_individual_standalone_exercises
    • 3671 interpret_quiz_text
    • 4509 doconce2format

And I have a question based on the source code. Why does Doconce support 5 equal characters (=) at maximum? There is surely need for more "depth" in titles, subtitles, chapter titles, subchapter titles, etc.

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

2 participants