search

xiota / geany-preview

Turns Geany into a markdown editor by providing a preview pane in the sidebar to show the formatting of several light-weight languages as they are edited. Supported document types include AsciiDoc, DocBook, Fountain, HTML, LaTeX, Markdown, MediaWiki, reStructuredText, Textile, and Txt2Tags.
GNU General Public License v3.0
15 stars 0 forks source link

one-liners for comments in preview.conf #16

Closed ralf3u closed 3 years ago

ralf3u commented 3 years ago

At the moment it seems to be that comments have only a certain number of signs per line to avoid long lines. This behavior has five disadvantages: 1) pressure for the author to use short sentences, although sometimes long sentences are necessary for a good explication, 2) harder for the author to edit multi-line comments, because there are some hash-signs between the sentence, 3) harder for the users to read, because it is not so fluid, 4) harder for the users to understand, because it is not so good explained, and 5) harder for the users to copy and paste it in translation tools, because there are some hash-signs between the lines.

If "Line Wrapping" would not exist in Geany, I would understand the use of multi-line comments. But maybe I missed something.

The request for using one-liners should not be used for lists, like for example:

#  - native*      - Use the built-in fountain processor
#  - screenplain  - Use screenplain (slower)
#  - disable      - Turn off Fountain screenplay previews

The idea to avoid multi-line comments was mentioned for the first time in https://github.com/xiota/geany-preview/issues/9#issuecomment-965687241.

xiota commented 3 years ago

Setting scheme changed in 9829a422e4cc4ad6b65b2589a868fd365e611992. PPA will be updated.