Daniel Dekany commented on FREEMARKER-97:

Thanks for the effort, I did not expect you to take any such steps. We can 
indeed use MIT licensed work without the explicit permission of the copyright 
holder, but then we have to include the copyright notice, etc., as the MIT 
license demands. Then that will also be a requirement for any project that 
packs FreeMarker, etc. So I prefer avoiding these legal complications as far as 
they can be with 1 hour of coding work. Anyway, now at least I will be more 
confident to take some rules from David Gouch's implementation... (:

> Header capitalization using standard styles
> -------------------------------------------
>                 Key: FREEMARKER-97
>                 URL: https://issues.apache.org/jira/browse/FREEMARKER-97
>             Project: Apache Freemarker
>          Issue Type: Wish
>          Components: engine
>    Affects Versions: 2.3.28
>            Reporter: T X
>            Priority: Minor
> FreeMarker offers a couple of simple algorithms for changing the case of 
> titles:
>  * 
> [https://freemarker.apache.org/docs/ref_builtins_string.html#ref_builtin_cap_firs|https://freemarker.apache.org/docs/ref_builtins_string.html#ref_builtin_cap_first]
>  * 
> [https://freemarker.apache.org/docs/ref_builtins_string.html#ref_builtin_capitalizet|https://freemarker.apache.org/docs/ref_builtins_string.html#ref_builtin_cap_first]
> Neither of these capitalize the text in ways that adhere to various standard 
> styles:
>  * [Chicago Manual of 
> Style|https://en.wikipedia.org/wiki/The_Chicago_Manual_of_Style]
>  * [Associated Press|https://en.wikipedia.org/wiki/AP_Stylebook]
>  * [MLA Style Manual|https://en.wikipedia.org/wiki/MLA_Style_Manual]
>  * [APA Style|https://en.wikipedia.org/wiki/APA_style]
> Consider the following texts:
>  * On iPhone the Transcript Extends Outside of Screen Frame
>  * PEAR And GNA Report Performance
>  * BCMailPlusFTPClient Sends Document without Document ID
>  * JWebUnit: Non-PEN Orders main.xhtml Meta Refresh Tag Issue
> These are correct as written and must not be adjusted by an algorithm that 
> changes the text title. There are a couple of web sites that produce the 
> expected titles (note that the second site capitalizes the word "without," 
> which implies the algorithm does not use Chicago conventions):
>  * [https://titlecaseconverter.com/]
>  * [http://individed.com/code/to-title-case/]
> There are a variety of implementations that perform such a feat:
> * 
> [JavaScript|https://github.com/gouch/to-title-case/blob/master/to-title-case.js]
> * [Perl|https://gist.github.com/gruber/9f9e8650d68b13ce4d78]
> * [PHP|https://gist.github.com/HipsterJazzbo/2532c93a18db7451b0cec529c95b53c4]
> These implementations do not require a whitelist. (So "iPhone" and 
> "ClassName" will remain as given.) Apache Commons' {{WordUtils}} class does 
> not implement Chicago Style, and I suspect it is also a fairly simple 
> algorithm.
> Since {{?capitalize}} and {{?cap_first}} are taken, I propose {{?title_case}} 
> with an optional parameter (default is Chicago):
>  * chicago
>  * ap
>  * apa
>  * mla

This message was sent by Atlassian JIRA

Reply via email to