You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@freemarker.apache.org by Jacques Le Roux <ja...@les7arts.com> on 2019/03/02 11:13:09 UTC
Re: Opinions about the new ?truncate built-in?
Hi Daniel,
I tried to test this morning using OFBiz, but I have not much time and freemarker:2.3.29 is not available in Maven (we use Jcenter in our Gradle
build, but I have a local m2 repository too)
https://maven-repository.com/artifact/org.freemarker/freemarker
So I'll wait its release to test except if you can explain me how to circumvent this issue using my local m2 repository too
Thanks
Jacques
Le 17/01/2019 à 20:13, Daniel Dekany a écrit :
> I have added the str?truncate(maxLength) built-in (and its other
> variations) to the 2.3-gae head. This is something that users have
> requested and implemented their own for who knows how many times, yet
> it wasn't added to FreeMarker till now, as there's no single correct
> way of text truncation. So what I did is making the algorithm
> pluggable, and giving a default that I think reflects a good practice.
> I guess most users will just go along (instead of quickly adding some
> simplistic #function their own), but those who have other ideas can
> still keep using ?truncate.
>
> Please tell your opinions, ideas, or even better, test it!
>
> >From https://freemarker.apache.org/builds/fm2/versions_2_3_29.html:
> Added new built-ins for truncating text. string?truncate(length)
> truncates the text to the given length, and by default adds [...] at
> the end if truncation has happened. Truncation happens at word
> boundaries, unless the result is too short that way, in which case it
> falls back to truncation mid word. There's also ?truncate_w to force
> Word Boundary truncation, and ?truncate_c (for Character Boundary)
> that doesn't care about word boundaries. The truncation algorithm is
> pluggable in the FreeMarker configuration. See the reference for more
> details.
>
> Built-in documentation:
> https://freemarker.apache.org/builds/fm2/ref_builtins_string.html#ref_builtin_truncate
>
> Related API-s:
> https://freemarker.apache.org/builds/fm2/api/freemarker/core/TruncateBuiltinAlgorithm.html
> https://freemarker.apache.org/builds/fm2/api/freemarker/core/DefaultTruncateBuiltinAlgorithm.html
> https://freemarker.apache.org/builds/fm2/api/freemarker/core/Configurable.html#setTruncateBuiltinAlgorithm-freemarker.core.TruncateBuiltinAlgorithm-
>
> Commit:
> https://github.com/apache/freemarker/commit/7c5ef10ef3da3b94fc5cdf9d61c966282b6cd8ac
>
Re: Opinions about the new ?truncate built-in?
Posted by Woonsan Ko <wo...@apache.org>.
On Wed, Mar 6, 2019 at 2:52 AM Daniel Dekany <dd...@apache.org> wrote:
>
> Sorry for the later reply...
>
> I have uploaded the current development version (so now it includes
> the lambda feature as well) to the Maven snapshot repository:
> https://repository.apache.org/content/repositories/snapshots/org/freemarker/freemarker/2.3.29-SNAPSHOT/
> https://repository.apache.org/content/repositories/snapshots/org/freemarker/freemarker-gae/2.3.29-SNAPSHOT/
>
> So, ensure that you have the
> https://repository.apache.org/content/repositories/snapshots/
> repository added to either the project pom.xml (maybe it's already
> there for OFBiz - I think it should be anyway), or to
> ~/.m2/settings.xml as snapshot repository:
>
> Version number is: 2.3.29-SNAPSHOT
>
> Woonsan: This is easier for someone who isn't already set up to build
> FreeMarker. See also:
> https://freemarker.apache.org/committer-howto.html#deploy-snapshot
Right. Makes sense. Thanks for the info!
Woonsan
>
>
> Saturday, March 2, 2019, 12:13:09 PM, Jacques Le Roux wrote:
>
> > Hi Daniel,
> >
> > I tried to test this morning using OFBiz, but I have not much time
> > and freemarker:2.3.29 is not available in Maven (we use Jcenter in our Gradle
> > build, but I have a local m2 repository too)
> >
> > https://maven-repository.com/artifact/org.freemarker/freemarker
> >
> > So I'll wait its release to test except if you can explain me how
> > to circumvent this issue using my local m2 repository too
> >
> > Thanks
> >
> > Jacques
> >
> > Le 17/01/2019 à 20:13, Daniel Dekany a écrit :
> >> I have added the str?truncate(maxLength) built-in (and its other
> >> variations) to the 2.3-gae head. This is something that users have
> >> requested and implemented their own for who knows how many times, yet
> >> it wasn't added to FreeMarker till now, as there's no single correct
> >> way of text truncation. So what I did is making the algorithm
> >> pluggable, and giving a default that I think reflects a good practice.
> >> I guess most users will just go along (instead of quickly adding some
> >> simplistic #function their own), but those who have other ideas can
> >> still keep using ?truncate.
> >>
> >> Please tell your opinions, ideas, or even better, test it!
> >>
> >> >From https://freemarker.apache.org/builds/fm2/versions_2_3_29.html:
> >> Added new built-ins for truncating text. string?truncate(length)
> >> truncates the text to the given length, and by default adds [...] at
> >> the end if truncation has happened. Truncation happens at word
> >> boundaries, unless the result is too short that way, in which case it
> >> falls back to truncation mid word. There's also ?truncate_w to force
> >> Word Boundary truncation, and ?truncate_c (for Character Boundary)
> >> that doesn't care about word boundaries. The truncation algorithm is
> >> pluggable in the FreeMarker configuration. See the reference for more
> >> details.
> >>
> >> Built-in documentation:
> >> https://freemarker.apache.org/builds/fm2/ref_builtins_string.html#ref_builtin_truncate
> >>
> >> Related API-s:
> >> https://freemarker.apache.org/builds/fm2/api/freemarker/core/TruncateBuiltinAlgorithm.html
> >> https://freemarker.apache.org/builds/fm2/api/freemarker/core/DefaultTruncateBuiltinAlgorithm.html
> >> https://freemarker.apache.org/builds/fm2/api/freemarker/core/Configurable.html#setTruncateBuiltinAlgorithm-freemarker.core.TruncateBuiltinAlgorithm-
> >>
> >> Commit:
> >> https://github.com/apache/freemarker/commit/7c5ef10ef3da3b94fc5cdf9d61c966282b6cd8ac
> >>
> >
>
> --
> Thanks,
> Daniel Dekany
>
Re: Opinions about the new ?truncate built-in?
Posted by Jacques Le Roux <ja...@les7arts.com>.
Thanks Daniel,
It will be delayed but I should test it this week
Jacques
Le 06/03/2019 à 08:52, Daniel Dekany a écrit :
> Sorry for the later reply...
>
> I have uploaded the current development version (so now it includes
> the lambda feature as well) to the Maven snapshot repository:
> https://repository.apache.org/content/repositories/snapshots/org/freemarker/freemarker/2.3.29-SNAPSHOT/
> https://repository.apache.org/content/repositories/snapshots/org/freemarker/freemarker-gae/2.3.29-SNAPSHOT/
>
> So, ensure that you have the
> https://repository.apache.org/content/repositories/snapshots/
> repository added to either the project pom.xml (maybe it's already
> there for OFBiz - I think it should be anyway), or to
> ~/.m2/settings.xml as snapshot repository:
>
> Version number is: 2.3.29-SNAPSHOT
>
> Woonsan: This is easier for someone who isn't already set up to build
> FreeMarker. See also:
> https://freemarker.apache.org/committer-howto.html#deploy-snapshot
>
>
> Saturday, March 2, 2019, 12:13:09 PM, Jacques Le Roux wrote:
>
>> Hi Daniel,
>>
>> I tried to test this morning using OFBiz, but I have not much time
>> and freemarker:2.3.29 is not available in Maven (we use Jcenter in our Gradle
>> build, but I have a local m2 repository too)
>>
>> https://maven-repository.com/artifact/org.freemarker/freemarker
>>
>> So I'll wait its release to test except if you can explain me how
>> to circumvent this issue using my local m2 repository too
>>
>> Thanks
>>
>> Jacques
>>
>> Le 17/01/2019 à 20:13, Daniel Dekany a écrit :
>>> I have added the str?truncate(maxLength) built-in (and its other
>>> variations) to the 2.3-gae head. This is something that users have
>>> requested and implemented their own for who knows how many times, yet
>>> it wasn't added to FreeMarker till now, as there's no single correct
>>> way of text truncation. So what I did is making the algorithm
>>> pluggable, and giving a default that I think reflects a good practice.
>>> I guess most users will just go along (instead of quickly adding some
>>> simplistic #function their own), but those who have other ideas can
>>> still keep using ?truncate.
>>>
>>> Please tell your opinions, ideas, or even better, test it!
>>>
>>> >From https://freemarker.apache.org/builds/fm2/versions_2_3_29.html:
>>> Added new built-ins for truncating text. string?truncate(length)
>>> truncates the text to the given length, and by default adds [...] at
>>> the end if truncation has happened. Truncation happens at word
>>> boundaries, unless the result is too short that way, in which case it
>>> falls back to truncation mid word. There's also ?truncate_w to force
>>> Word Boundary truncation, and ?truncate_c (for Character Boundary)
>>> that doesn't care about word boundaries. The truncation algorithm is
>>> pluggable in the FreeMarker configuration. See the reference for more
>>> details.
>>>
>>> Built-in documentation:
>>> https://freemarker.apache.org/builds/fm2/ref_builtins_string.html#ref_builtin_truncate
>>>
>>> Related API-s:
>>> https://freemarker.apache.org/builds/fm2/api/freemarker/core/TruncateBuiltinAlgorithm.html
>>> https://freemarker.apache.org/builds/fm2/api/freemarker/core/DefaultTruncateBuiltinAlgorithm.html
>>> https://freemarker.apache.org/builds/fm2/api/freemarker/core/Configurable.html#setTruncateBuiltinAlgorithm-freemarker.core.TruncateBuiltinAlgorithm-
>>>
>>> Commit:
>>> https://github.com/apache/freemarker/commit/7c5ef10ef3da3b94fc5cdf9d61c966282b6cd8ac
>>>
Re: Opinions about the new ?truncate built-in?
Posted by Daniel Dekany <dd...@apache.org>.
Sorry for the later reply...
I have uploaded the current development version (so now it includes
the lambda feature as well) to the Maven snapshot repository:
https://repository.apache.org/content/repositories/snapshots/org/freemarker/freemarker/2.3.29-SNAPSHOT/
https://repository.apache.org/content/repositories/snapshots/org/freemarker/freemarker-gae/2.3.29-SNAPSHOT/
So, ensure that you have the
https://repository.apache.org/content/repositories/snapshots/
repository added to either the project pom.xml (maybe it's already
there for OFBiz - I think it should be anyway), or to
~/.m2/settings.xml as snapshot repository:
Version number is: 2.3.29-SNAPSHOT
Woonsan: This is easier for someone who isn't already set up to build
FreeMarker. See also:
https://freemarker.apache.org/committer-howto.html#deploy-snapshot
Saturday, March 2, 2019, 12:13:09 PM, Jacques Le Roux wrote:
> Hi Daniel,
>
> I tried to test this morning using OFBiz, but I have not much time
> and freemarker:2.3.29 is not available in Maven (we use Jcenter in our Gradle
> build, but I have a local m2 repository too)
>
> https://maven-repository.com/artifact/org.freemarker/freemarker
>
> So I'll wait its release to test except if you can explain me how
> to circumvent this issue using my local m2 repository too
>
> Thanks
>
> Jacques
>
> Le 17/01/2019 à 20:13, Daniel Dekany a écrit :
>> I have added the str?truncate(maxLength) built-in (and its other
>> variations) to the 2.3-gae head. This is something that users have
>> requested and implemented their own for who knows how many times, yet
>> it wasn't added to FreeMarker till now, as there's no single correct
>> way of text truncation. So what I did is making the algorithm
>> pluggable, and giving a default that I think reflects a good practice.
>> I guess most users will just go along (instead of quickly adding some
>> simplistic #function their own), but those who have other ideas can
>> still keep using ?truncate.
>>
>> Please tell your opinions, ideas, or even better, test it!
>>
>> >From https://freemarker.apache.org/builds/fm2/versions_2_3_29.html:
>> Added new built-ins for truncating text. string?truncate(length)
>> truncates the text to the given length, and by default adds [...] at
>> the end if truncation has happened. Truncation happens at word
>> boundaries, unless the result is too short that way, in which case it
>> falls back to truncation mid word. There's also ?truncate_w to force
>> Word Boundary truncation, and ?truncate_c (for Character Boundary)
>> that doesn't care about word boundaries. The truncation algorithm is
>> pluggable in the FreeMarker configuration. See the reference for more
>> details.
>>
>> Built-in documentation:
>> https://freemarker.apache.org/builds/fm2/ref_builtins_string.html#ref_builtin_truncate
>>
>> Related API-s:
>> https://freemarker.apache.org/builds/fm2/api/freemarker/core/TruncateBuiltinAlgorithm.html
>> https://freemarker.apache.org/builds/fm2/api/freemarker/core/DefaultTruncateBuiltinAlgorithm.html
>> https://freemarker.apache.org/builds/fm2/api/freemarker/core/Configurable.html#setTruncateBuiltinAlgorithm-freemarker.core.TruncateBuiltinAlgorithm-
>>
>> Commit:
>> https://github.com/apache/freemarker/commit/7c5ef10ef3da3b94fc5cdf9d61c966282b6cd8ac
>>
>
--
Thanks,
Daniel Dekany
Re: Opinions about the new ?truncate built-in?
Posted by Woonsan Ko <wo...@apache.org>.
On Mon, Mar 4, 2019 at 1:29 PM Jacques Le Roux
<ja...@les7arts.com> wrote:
>
> Thanks Woonsan,
You're welcome. :-)
BTW, if not done yet, please follow the "Building FreeMarker" section
in the README.md file. That is,
- `ant download-ivy` if ivy isn't installed yet on your machine.
- Copy build.properties.sample to build.properties. Just set
"boot.classpath.j2se1.8=..." property and "mvnCommand=..." property
for your env. You can comment out "boot.classpath.j2se1.5" and
"boot.classpath.j2se1.6" on JDK 1.8.
That will be it.
Woonsan
>
> I'll do that :)
>
> Jacques
>
> Le 04/03/2019 à 06:20, Woonsan Ko a écrit :
> > On Sat, Mar 2, 2019 at 6:15 AM Jacques Le Roux
> > <ja...@les7arts.com> wrote:
> >> Hi Daniel,
> >>
> >> I tried to test this morning using OFBiz, but I have not much time and freemarker:2.3.29 is not available in Maven (we use Jcenter in our Gradle
> >> build, but I have a local m2 repository too)
> >>
> >> https://maven-repository.com/artifact/org.freemarker/freemarker
> >>
> >> So I'll wait its release to test except if you can explain me how to circumvent this issue using my local m2 repository too
> > For another feature (lambda), I tested the feature with a local maven install:
> >
> > 1. Pull and check out 2.3 branch. (I had to use 2.3-gae branch for
> > lambda feature, but the feature in this thread was also in 2.3
> > branch.)
> > 2. Build with `ant jar maven-install` (which will build and install
> > the jar into your local maven repo.)
> > 3. Change the FreeMarker dependency version in your project to 2.3.29-SNAPHSOT.
> > 4. Build/run/test your project.
> >
> > Regards,
> >
> > Woonsan
> >
> >> Thanks
> >>
> >> Jacques
> >>
> >> Le 17/01/2019 à 20:13, Daniel Dekany a écrit :
> >>> I have added the str?truncate(maxLength) built-in (and its other
> >>> variations) to the 2.3-gae head. This is something that users have
> >>> requested and implemented their own for who knows how many times, yet
> >>> it wasn't added to FreeMarker till now, as there's no single correct
> >>> way of text truncation. So what I did is making the algorithm
> >>> pluggable, and giving a default that I think reflects a good practice.
> >>> I guess most users will just go along (instead of quickly adding some
> >>> simplistic #function their own), but those who have other ideas can
> >>> still keep using ?truncate.
> >>>
> >>> Please tell your opinions, ideas, or even better, test it!
> >>>
> >>> >From https://freemarker.apache.org/builds/fm2/versions_2_3_29.html:
> >>> Added new built-ins for truncating text. string?truncate(length)
> >>> truncates the text to the given length, and by default adds [...] at
> >>> the end if truncation has happened. Truncation happens at word
> >>> boundaries, unless the result is too short that way, in which case it
> >>> falls back to truncation mid word. There's also ?truncate_w to force
> >>> Word Boundary truncation, and ?truncate_c (for Character Boundary)
> >>> that doesn't care about word boundaries. The truncation algorithm is
> >>> pluggable in the FreeMarker configuration. See the reference for more
> >>> details.
> >>>
> >>> Built-in documentation:
> >>> https://freemarker.apache.org/builds/fm2/ref_builtins_string.html#ref_builtin_truncate
> >>>
> >>> Related API-s:
> >>> https://freemarker.apache.org/builds/fm2/api/freemarker/core/TruncateBuiltinAlgorithm.html
> >>> https://freemarker.apache.org/builds/fm2/api/freemarker/core/DefaultTruncateBuiltinAlgorithm.html
> >>> https://freemarker.apache.org/builds/fm2/api/freemarker/core/Configurable.html#setTruncateBuiltinAlgorithm-freemarker.core.TruncateBuiltinAlgorithm-
> >>>
> >>> Commit:
> >>> https://github.com/apache/freemarker/commit/7c5ef10ef3da3b94fc5cdf9d61c966282b6cd8ac
> >>>
Re: Opinions about the new ?truncate built-in?
Posted by Jacques Le Roux <ja...@les7arts.com>.
Thanks Woonsan,
I'll do that :)
Jacques
Le 04/03/2019 à 06:20, Woonsan Ko a écrit :
> On Sat, Mar 2, 2019 at 6:15 AM Jacques Le Roux
> <ja...@les7arts.com> wrote:
>> Hi Daniel,
>>
>> I tried to test this morning using OFBiz, but I have not much time and freemarker:2.3.29 is not available in Maven (we use Jcenter in our Gradle
>> build, but I have a local m2 repository too)
>>
>> https://maven-repository.com/artifact/org.freemarker/freemarker
>>
>> So I'll wait its release to test except if you can explain me how to circumvent this issue using my local m2 repository too
> For another feature (lambda), I tested the feature with a local maven install:
>
> 1. Pull and check out 2.3 branch. (I had to use 2.3-gae branch for
> lambda feature, but the feature in this thread was also in 2.3
> branch.)
> 2. Build with `ant jar maven-install` (which will build and install
> the jar into your local maven repo.)
> 3. Change the FreeMarker dependency version in your project to 2.3.29-SNAPHSOT.
> 4. Build/run/test your project.
>
> Regards,
>
> Woonsan
>
>> Thanks
>>
>> Jacques
>>
>> Le 17/01/2019 à 20:13, Daniel Dekany a écrit :
>>> I have added the str?truncate(maxLength) built-in (and its other
>>> variations) to the 2.3-gae head. This is something that users have
>>> requested and implemented their own for who knows how many times, yet
>>> it wasn't added to FreeMarker till now, as there's no single correct
>>> way of text truncation. So what I did is making the algorithm
>>> pluggable, and giving a default that I think reflects a good practice.
>>> I guess most users will just go along (instead of quickly adding some
>>> simplistic #function their own), but those who have other ideas can
>>> still keep using ?truncate.
>>>
>>> Please tell your opinions, ideas, or even better, test it!
>>>
>>> >From https://freemarker.apache.org/builds/fm2/versions_2_3_29.html:
>>> Added new built-ins for truncating text. string?truncate(length)
>>> truncates the text to the given length, and by default adds [...] at
>>> the end if truncation has happened. Truncation happens at word
>>> boundaries, unless the result is too short that way, in which case it
>>> falls back to truncation mid word. There's also ?truncate_w to force
>>> Word Boundary truncation, and ?truncate_c (for Character Boundary)
>>> that doesn't care about word boundaries. The truncation algorithm is
>>> pluggable in the FreeMarker configuration. See the reference for more
>>> details.
>>>
>>> Built-in documentation:
>>> https://freemarker.apache.org/builds/fm2/ref_builtins_string.html#ref_builtin_truncate
>>>
>>> Related API-s:
>>> https://freemarker.apache.org/builds/fm2/api/freemarker/core/TruncateBuiltinAlgorithm.html
>>> https://freemarker.apache.org/builds/fm2/api/freemarker/core/DefaultTruncateBuiltinAlgorithm.html
>>> https://freemarker.apache.org/builds/fm2/api/freemarker/core/Configurable.html#setTruncateBuiltinAlgorithm-freemarker.core.TruncateBuiltinAlgorithm-
>>>
>>> Commit:
>>> https://github.com/apache/freemarker/commit/7c5ef10ef3da3b94fc5cdf9d61c966282b6cd8ac
>>>
Re: Opinions about the new ?truncate built-in?
Posted by Woonsan Ko <wo...@apache.org>.
On Sat, Mar 2, 2019 at 6:15 AM Jacques Le Roux
<ja...@les7arts.com> wrote:
>
> Hi Daniel,
>
> I tried to test this morning using OFBiz, but I have not much time and freemarker:2.3.29 is not available in Maven (we use Jcenter in our Gradle
> build, but I have a local m2 repository too)
>
> https://maven-repository.com/artifact/org.freemarker/freemarker
>
> So I'll wait its release to test except if you can explain me how to circumvent this issue using my local m2 repository too
For another feature (lambda), I tested the feature with a local maven install:
1. Pull and check out 2.3 branch. (I had to use 2.3-gae branch for
lambda feature, but the feature in this thread was also in 2.3
branch.)
2. Build with `ant jar maven-install` (which will build and install
the jar into your local maven repo.)
3. Change the FreeMarker dependency version in your project to 2.3.29-SNAPHSOT.
4. Build/run/test your project.
Regards,
Woonsan
>
> Thanks
>
> Jacques
>
> Le 17/01/2019 à 20:13, Daniel Dekany a écrit :
> > I have added the str?truncate(maxLength) built-in (and its other
> > variations) to the 2.3-gae head. This is something that users have
> > requested and implemented their own for who knows how many times, yet
> > it wasn't added to FreeMarker till now, as there's no single correct
> > way of text truncation. So what I did is making the algorithm
> > pluggable, and giving a default that I think reflects a good practice.
> > I guess most users will just go along (instead of quickly adding some
> > simplistic #function their own), but those who have other ideas can
> > still keep using ?truncate.
> >
> > Please tell your opinions, ideas, or even better, test it!
> >
> > >From https://freemarker.apache.org/builds/fm2/versions_2_3_29.html:
> > Added new built-ins for truncating text. string?truncate(length)
> > truncates the text to the given length, and by default adds [...] at
> > the end if truncation has happened. Truncation happens at word
> > boundaries, unless the result is too short that way, in which case it
> > falls back to truncation mid word. There's also ?truncate_w to force
> > Word Boundary truncation, and ?truncate_c (for Character Boundary)
> > that doesn't care about word boundaries. The truncation algorithm is
> > pluggable in the FreeMarker configuration. See the reference for more
> > details.
> >
> > Built-in documentation:
> > https://freemarker.apache.org/builds/fm2/ref_builtins_string.html#ref_builtin_truncate
> >
> > Related API-s:
> > https://freemarker.apache.org/builds/fm2/api/freemarker/core/TruncateBuiltinAlgorithm.html
> > https://freemarker.apache.org/builds/fm2/api/freemarker/core/DefaultTruncateBuiltinAlgorithm.html
> > https://freemarker.apache.org/builds/fm2/api/freemarker/core/Configurable.html#setTruncateBuiltinAlgorithm-freemarker.core.TruncateBuiltinAlgorithm-
> >
> > Commit:
> > https://github.com/apache/freemarker/commit/7c5ef10ef3da3b94fc5cdf9d61c966282b6cd8ac
> >