doc icon indicating copy to clipboard operation
doc copied to clipboard

Add smartypants extension to enhance typography

Open tituspijean opened this issue 3 years ago • 5 comments

cf. https://github.com/YunoHost/doc/pull/1716

Adding smartypants extension beautifies and respects typography laws by using the curved apostrophes and quotation marks, and even offers to display French guillemets. Documentation has been updated accordingly.

  • [ ] Backend task @tituspijean: install said extension.

tituspijean avatar Jul 11 '21 20:07 tituspijean

I don't see how it doesn't apply to other content than fr ?

zamentur avatar Jul 12 '21 10:07 zamentur

It indeed does not discriminate between languages for now. However, per Wikipedia, both apostrophes and quotation marks in English can be used with their curved, typographic version.

This PR does not specifically target French, even though the issue arose from the French translation. From the second link, I see we may have issues with the German version (inverted location). I could have a look into it, could be a simple if to apply somewhere in the code.

tituspijean avatar Jul 12 '21 11:07 tituspijean

idk if this correctly take care of avoiding reformating code snippets like in <pre> of <codeblock> tag, otherwise that could break a lot of command line that people cold copy paste (already experienced that)

tbh I find people forcing for The Right French Typography so annoying that I don't want to hear about it anymore but that's not a real argument.

Psycojoker avatar Jul 12 '21 19:07 Psycojoker

idk if this correctly take care of avoiding reformating code snippets like in <pre> or <codeblock> tag, otherwise that could break a lot of command line that people cold copy paste (already experienced that)

You can check it out on my test server (ynh.pijean.ovh/fr/packaging_apps_arguments_format). Code blocks are excluded (as stated in the doc of the extension).

tbh I find people forcing for The Right French Typography so annoying that I don't want to hear about it anymore but that's not a real argument.

I hear you. I am merely proposing a lazy way of handling it, while maintaining our habits of using ' and ".

tituspijean avatar Jul 12 '21 20:07 tituspijean

The plugin clashes with the Shortcode-UI tabs extension. Do not merge.

tituspijean avatar Jul 15 '21 16:07 tituspijean