source/text/scalc/00/00000412.xhp | 19 +++++++- source/text/scalc/01/12030200.xhp | 89 +++++++++++++++++++++----------------- 2 files changed, 68 insertions(+), 40 deletions(-)
New commits: commit 1e66ff8bd5bc9a11551a0b7246b443b992cdccd4 Author: Olivier Hallot <[email protected]> AuthorDate: Wed Nov 5 18:13:37 2025 -0300 Commit: Olivier Hallot <[email protected]> CommitDate: Thu Nov 6 11:48:19 2025 +0100 tdf#168917 Sort options includes natural sorting + Refactor + Added text for the natural sort choices + Update how to get Change-Id: If6ed18510baa49a9a95ead9145a67aa0c2396c1b Reviewed-on: https://gerrit.libreoffice.org/c/help/+/193499 Tested-by: Jenkins Reviewed-by: Olivier Hallot <[email protected]> diff --git a/source/text/scalc/00/00000412.xhp b/source/text/scalc/00/00000412.xhp index efd099e242..741c831b80 100644 --- a/source/text/scalc/00/00000412.xhp +++ b/source/text/scalc/00/00000412.xhp @@ -182,7 +182,24 @@ </section> </section> </section> - <paragraph role="paragraph" id="par_id3146984"><variable id="dnstot">Choose <emph>Data - Sort - Options</emph> tab.</variable></paragraph> + + <section id="dnstot1"> + <embed href="text/shared/00/00000004.xhp#from_menu_bar"/> + <paragraph role="paragraph" id="par_id3146984"><variable id="dnstot">Choose <emph>Data - Sort - Options</emph> tab.</variable></paragraph> + <embed href="text/shared/00/00000004.xhp#from_tabUI"/> + <paragraph role="paragraph" id="par_id621762376602839">Choose <menuitem>Data - Sort - Options</menuitem> tab.</paragraph> + <embed href="text/shared/00/00000004.xhp#from_toolbars"/> + <table id="tab_id151762376647500"> + <tablerow> + <tablecell> + <paragraph id="par_id951762376647500" role="paragraph"><image src="cmd/lc_datasort.svg" id="img_id31762376647500" width="1cm" height="1cm"><alt id="alt_id581762376647500">Icon Sort</alt></image></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id241762376647500" role="paragraph">Sort, then Options tab.</paragraph> + </tablecell> + </tablerow> + </table> + </section> <section id="filtermenu"> <embed href="text/shared/00/00000004.xhp#from_menu_bar"/> diff --git a/source/text/scalc/01/12030200.xhp b/source/text/scalc/01/12030200.xhp index 9c9ed54e7d..7a0a57273d 100644 --- a/source/text/scalc/01/12030200.xhp +++ b/source/text/scalc/01/12030200.xhp @@ -20,7 +20,7 @@ <meta> <topic id="textscalc0112030200xml" indexer="include" status="PUBLISH"> -<title id="tit" xml-lang="en-US">Options</title> +<title id="tit">Sort Options</title> <filename>/text/scalc/01/12030200.xhp</filename> </topic> <history> @@ -28,68 +28,79 @@ </history> </meta> <body> -<section id="options"> -<bookmark xml-lang="en-US" branch="index" id="bm_id3147228"><bookmark_value>sorting; options for database ranges</bookmark_value> +<bookmark branch="index" id="bm_id3147228"> +<bookmark_value>sorting; options for database ranges</bookmark_value> <bookmark_value>sorting;Asian languages</bookmark_value> <bookmark_value>Asian languages;sorting</bookmark_value> <bookmark_value>phonebook sorting rules</bookmark_value> <bookmark_value>natural sort algorithm</bookmark_value> </bookmark> -<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sortoptionspage/SortOptionsPage" id="bm_id3151044" localize="false"/> -<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sortoptionspage/@@nowidget@@" id="bm_id3151044" localize="false"/> -<h1 id="hd_id3147228" xml-lang="en-US"><link href="text/scalc/01/12030200.xhp"> Options</link></h1> -<paragraph role="paragraph" id="par_id3153770" xml-lang="en-US"><ahelp hid="modules/scalc/ui/sortoptionspage/SortOptionsPage"> Sets additional sorting options.</ahelp></paragraph> +<bookmark branch="hid/modules/scalc/ui/sortoptionspage/SortOptionsPage" id="bm_id3151044" localize="false"/> +<bookmark branch="hid/modules/scalc/ui/sortoptionspage/@@nowidget@@" id="bm_id3151044" localize="false"/> +<section id="options"> +<h1 id="hd_id3147228"><link href="text/scalc/01/12030200.xhp">Sort Options</link></h1> +<description id="par_id3153770"><ahelp hid="modules/scalc/ui/sortoptionspage/SortOptionsPage">Sets additional sorting options such as natural sorting, locale for sorting, handling columns boundaries, sort results location and more.</ahelp></description> </section> <section id="howtoget"> - <embed href="text/scalc/00/00000412.xhp#dnstot"/> + <embed href="text/scalc/00/00000412.xhp#dnstot1"/> </section> -<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sortoptionspage/case" id="bm_id3149664" localize="false"/> -<h2 id="hd_id3146976" xml-lang="en-US">Case sensitive</h2> -<paragraph role="paragraph" id="par_id3153091" xml-lang="en-US"><ahelp hid="modules/scalc/ui/sortoptionspage/case">Sorts first by uppercase letters and then by lowercase letters. For Asian locales, special handling applies.</ahelp></paragraph> -<note id="par_idN10637" xml-lang="en-US">For Asian locales: Check <emph>Case Sensitive</emph> to apply multi-level collation. With multi-level collation, entries are first compared in their primitive forms with their cases and diacritics ignored. If they evaluate as the same, their diacritics are taken into account for the second-level comparison. If they still evaluate as the same, their cases, character widths, and Japanese Kana difference are considered for the third-level comparison.<comment>UFI: see #112590# and #112507#</comment></note> -<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sortoptionspage/header" id="bm_id3145271" localize="false"/> +<bookmark branch="hid/modules/scalc/ui/sortoptionspage/case" id="bm_id3149664" localize="false"/> +<h2 id="hd_id3146976">Case sensitive</h2> +<paragraph role="paragraph" id="par_id3153091"><ahelp hid="modules/scalc/ui/sortoptionspage/case">Sorts first by lowercase letters and then by uppercase letters. For Asian locales, special handling applies.</ahelp></paragraph> +<note id="par_idN10637">For Asian locales: Check <emph>Case Sensitive</emph> to apply multi-level collation. With multi-level collation, entries are first compared in their primitive forms with their cases and diacritics ignored. If they evaluate as the same, their diacritics are taken into account for the second-level comparison. If they still evaluate as the same, their cases, character widths, and Japanese Kana difference are considered for the third-level comparison.<comment>UFI: see #112590# and #112507#</comment></note> +<bookmark branch="hid/modules/scalc/ui/sortoptionspage/header" id="bm_id3145271" localize="false"/> <h2 id="hd_id3155856">Range contains row/column labels</h2> -<paragraph role="paragraph" id="par_id3154014" xml-lang="en-US"><ahelp hid="modules/scalc/ui/sortoptionspage/header"> Omits the first row or the first column in the selection from the sort.</ahelp> The <emph>Direction</emph> setting at the bottom of the dialog defines the name and function of this check box.</paragraph> -<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sortoptionspage/formats" id="bm_id3149410" localize="false"/> -<h2 id="hd_id3147436"> Include formats</h2> -<paragraph role="paragraph" id="par_id3149377" xml-lang="en-US"><ahelp hid="modules/scalc/ui/sortoptionspage/formats"> Preserves the current cell formatting.</ahelp></paragraph> -<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sortoptionspage/naturalsort" id="bm_id3149412" localize="false"/> +<paragraph role="paragraph" id="par_id3154014"><ahelp hid="modules/scalc/ui/sortoptionspage/header"> Omits the first row or the first column in the selection from the sort.</ahelp> The <emph>Direction</emph> setting at the bottom of the dialog defines the name and function of this check box.</paragraph> +<bookmark branch="hid/modules/scalc/ui/sortoptionspage/formats" id="bm_id3149410" localize="false"/> +<h2 id="hd_id3147436">Include formats</h2> +<paragraph role="paragraph" id="par_id3149377"><ahelp hid="modules/scalc/ui/sortoptionspage/formats"> Preserves the current cell formatting.</ahelp></paragraph> +<bookmark branch="hid/modules/scalc/ui/sortoptionspage/naturalsort" id="bm_id3149412" localize="false"/> <h2 id="hd_id3147438">Enable natural sort</h2> -<paragraph role="paragraph" id="par_id3149378" xml-lang="en-US"><ahelp hid="modules/scalc/ui/sortoptionspage/naturalsort">Natural sort is a sort algorithm that sorts string-prefixed numbers based on the value of the numerical element in each sorted number, instead of the traditional way of sorting them as ordinary strings.</ahelp> For instance, let's assume you have a series of values such as, A1, A2, A3, A4, A5, A6, ..., A19, A20, A21. When you put these values into a range of cells and run the sort, it will become A1, A11, A12, A13, ..., A19, A2, A20, A21, A3, A4, A5, ..., A9. While this sorting behavior may make sense to those who understand the underlying sorting mechanism, to the rest of the population it seems completely bizarre, if not outright inconvenient. With the natural sort feature enabled, values such as the ones in the above example get sorted "properly", which improves the convenience of sorting operations in general.</paragraph> -<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sortoptionspage/includenotes" id="bm_id331610760238867" localize="false"/> +<paragraph role="paragraph" id="par_id3149378"><ahelp hid="modules/scalc/ui/sortoptionspage/naturalsort">Natural sorting is an algorithm that orders string-prefixed numbers by their numerical value, rather than treating them as plain text for comparison.</ahelp></paragraph> +<paragraph role="paragraph" id="par_id961762374380866">Example: the series of values A1, A15, A9, A4, A5, A17, ..., A2, A13, A21 when <emph>sorted in natural order</emph> becomes</paragraph> +<paragraph role="paragraph" id="par_id1001762374404777" localize="false">A1, A2, A3, A4, A5, A6, ..., A19, A20, A21.</paragraph> +<paragraph role="paragraph" id="par_id601762374401049">The same set of values not sorted naturally becomes</paragraph> +<paragraph role="paragraph" id="par_id841762374395378" localize="false">A1, A11, A12, A13, ..., A19, A2, A20, A21, A3, A4, A5, ..., A9.</paragraph> +<bookmark branch="hid/modules/scalc/ui/sortoptionspage/doublenaturalsortrb" id="bm_id431762372812824" localize="false"/> +<h3 id="hd_id431762372773602">Recognize decimal separator</h3> +<paragraph role="paragraph" id="par_id201762373514680">The decimal separator character, which varies by locale, when included in the number that follows the text, indicate that it is a decimal number. For example: A1.14, A1.2, A2.5, A10 (with a dot as the separator).</paragraph> +<bookmark branch="hid/modules/scalc/ui/sortoptionspage/integernaturalsortrb" id="bm_id651762372755724" localize="false"/> +<h3 id="hd_id591762372844039">Decimal separator as regular character</h3> +<paragraph role="paragraph" id="par_id191762373791747">The decimal separator character, which varies by locale, does not indicate a decimal number when included in the following text; instead, it is treated as a regular character. For example, A1.14 contains character 'A', number 1, character '.' and number 14.</paragraph> +<bookmark branch="hid/modules/scalc/ui/sortoptionspage/includenotes" id="bm_id331610760238867" localize="false"/> <h2 id="hd_id71610757096466">Include boundary column(s)/row(s) containing only comments</h2> <paragraph role="paragraph" id="par_id431610757186031">Range boundary columns (for sorting rows) or boundary rows (for sorting columns) of a sorting range are not sorted by default if they are empty. Check this option if boundary columns or boundary rows containing comments are also to be sorted.</paragraph> -<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sortoptionspage/includeimages" id="bm_id331610760238867" localize="false"/> +<bookmark branch="hid/modules/scalc/ui/sortoptionspage/includeimages" id="bm_id331610760238867" localize="false"/> <h2 id="hd_id161610757296697">Include boundary column(s)/row(s) containing only images</h2> <paragraph role="paragraph" id="par_id181610758875786">Border columns (for sorting rows) or border rows (for sorting columns) of a sorting area are not sorted by default if they are empty. Check this option if boundary columns or boundary rows containing images are also to be sorted.</paragraph> -<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sortoptionspage/copyresult" id="bm_id3147124" localize="false"/> +<bookmark branch="hid/modules/scalc/ui/sortoptionspage/copyresult" id="bm_id3147124" localize="false"/> <h2 id="hd_id3153878"> Copy sort results to:</h2> -<paragraph role="paragraph" id="par_id3156286" xml-lang="en-US"><ahelp hid="modules/scalc/ui/sortoptionspage/copyresult"> Copies the sorted list to the cell range that you specify.</ahelp></paragraph> -<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sortoptionspage/outarealb" id="bm_id3149403" localize="false"/> +<paragraph role="paragraph" id="par_id3156286"><ahelp hid="modules/scalc/ui/sortoptionspage/copyresult"> Copies the sorted list to the cell range that you specify.</ahelp></paragraph> +<bookmark branch="hid/modules/scalc/ui/sortoptionspage/outarealb" id="bm_id3149403" localize="false"/> <h3 id="hd_id3153418"> Sort results (named ranges list)</h3> -<paragraph role="paragraph" id="par_id3155602" xml-lang="en-US"><ahelp hid="modules/scalc/ui/sortoptionspage/outarealb"> Select a named <link href="text/scalc/01/12010000.xhp"> cell range</link> where you want to display the sorted list.</ahelp></paragraph> -<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sortoptionspage/outareaed" id="bm_id3153767" localize="false"/> +<paragraph role="paragraph" id="par_id3155602"><ahelp hid="modules/scalc/ui/sortoptionspage/outarealb"> Select a named <link href="text/scalc/01/12010000.xhp"> cell range</link> where you want to display the sorted list.</ahelp></paragraph> +<bookmark branch="hid/modules/scalc/ui/sortoptionspage/outareaed" id="bm_id3153767" localize="false"/> <h3 id="hd_id3153707"> Sort results (input box)</h3> -<paragraph role="paragraph" id="par_id3145642" xml-lang="en-US"><ahelp hid="modules/scalc/ui/sortoptionspage/outareaed">Enter the cell range where you want to display the sorted list.</ahelp></paragraph> -<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sortoptionspage/sortuser" id="bm_id3147339" localize="false"/> +<paragraph role="paragraph" id="par_id3145642"><ahelp hid="modules/scalc/ui/sortoptionspage/outareaed">Enter the cell range where you want to display the sorted list.</ahelp></paragraph> +<bookmark branch="hid/modules/scalc/ui/sortoptionspage/sortuser" id="bm_id3147339" localize="false"/> <h2 id="hd_id3155445"> Custom sort order</h2> -<paragraph role="paragraph" id="par_id3156385" xml-lang="en-US"><ahelp hid="modules/scalc/ui/sortoptionspage/sortuser"> Click here and then select the custom sort order that you want.</ahelp></paragraph> -<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sortoptionspage/sortuserlb" id="bm_id3146917" localize="false"/> +<paragraph role="paragraph" id="par_id3156385"><ahelp hid="modules/scalc/ui/sortoptionspage/sortuser"> Click here and then select the custom sort order that you want.</ahelp></paragraph> +<bookmark branch="hid/modules/scalc/ui/sortoptionspage/sortuserlb" id="bm_id3146917" localize="false"/> <h3 id="hd_id3154704"> Custom sort order list</h3> -<paragraph role="paragraph" id="par_id3155962" xml-lang="en-US"><ahelp hid="modules/scalc/ui/sortoptionspage/sortuserlb"> Select the custom sort order that you want to apply. To define a custom sort order, choose <switchinline select="sys"><caseinline select="MAC"><menuitem>%PRODUCTNAME - Preferences</menuitem></caseinline><defaultinline><menuitem>Tools - Options</menuitem></defaultinline></switchinline> - <link href="text/shared/optionen/01060400.xhp"><menuitem>%PRODUCTNAME Calc - Sort Lists</menuitem></link>.</ahelp></paragraph> +<paragraph role="paragraph" id="par_id3155962"><ahelp hid="modules/scalc/ui/sortoptionspage/sortuserlb"> Select the custom sort order that you want to apply. To define a custom sort order, choose <switchinline select="sys"><caseinline select="MAC"><menuitem>%PRODUCTNAME - Preferences</menuitem></caseinline><defaultinline><menuitem>Tools - Options</menuitem></defaultinline></switchinline> - <link href="text/shared/optionen/01060400.xhp"><menuitem>%PRODUCTNAME Calc - Sort Lists</menuitem></link>.</ahelp></paragraph> <h2 id="hd_id3149257"> Locale</h2> -<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sortoptionspage/language" id="bm_id3150299" localize="false"/> +<bookmark branch="hid/modules/scalc/ui/sortoptionspage/language" id="bm_id3150299" localize="false"/> <h3 id="hd_id3147004"> Locale</h3> -<paragraph role="paragraph" id="par_id3150787" xml-lang="en-US"><ahelp hid="modules/scalc/ui/sortoptionspage/language"> Select the locale for the sorting rules.</ahelp></paragraph> -<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sortoptionspage/algorithmlb" id="bm_id3150304" localize="false"/> +<paragraph role="paragraph" id="par_id3150787"><ahelp hid="modules/scalc/ui/sortoptionspage/language"> Select the locale for the sorting rules.</ahelp></paragraph> +<bookmark branch="hid/modules/scalc/ui/sortoptionspage/algorithmlb" id="bm_id3150304" localize="false"/> <h3 id="hd_id3150344"> Options</h3> -<paragraph role="paragraph" id="par_id3155113" xml-lang="en-US"><ahelp hid="modules/scalc/ui/sortoptionspage/algorithmlb"> Select a sorting option for the locale.</ahelp> For example, select the "phonebook" option for German to include the umlaut special character in the sorting.</paragraph> +<paragraph role="paragraph" id="par_id3155113"><ahelp hid="modules/scalc/ui/sortoptionspage/algorithmlb"> Select a sorting option for the locale.</ahelp> For example, select the "phonebook" option for German to include the umlaut special character in the sorting.</paragraph> <h2 id="hd_id3152580"> Direction</h2> -<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sortoptionspage/topdown" id="bm_id3155507" localize="false"/> +<bookmark branch="hid/modules/scalc/ui/sortoptionspage/topdown" id="bm_id3155507" localize="false"/> <h3 id="hd_id3154201"> Top to Bottom (Sort Rows)</h3> -<paragraph role="paragraph" id="par_id3166430" xml-lang="en-US"><ahelp hid="modules/scalc/ui/sortoptionspage/topdown"> Sorts rows by the values in the active columns of the selected range.</ahelp></paragraph> -<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sortoptionspage/leftright" id="bm_id3155529" localize="false"/> +<paragraph role="paragraph" id="par_id3166430"><ahelp hid="modules/scalc/ui/sortoptionspage/topdown"> Sorts rows by the values in the active columns of the selected range.</ahelp></paragraph> +<bookmark branch="hid/modules/scalc/ui/sortoptionspage/leftright" id="bm_id3155529" localize="false"/> <h3 id="hd_id3145588"> Left to Right (Sort Columns)</h3> -<paragraph role="paragraph" id="par_id3154370" xml-lang="en-US"><ahelp hid="modules/scalc/ui/sortoptionspage/leftright"> Sorts columns by the values in the active rows of the selected range.</ahelp></paragraph> +<paragraph role="paragraph" id="par_id3154370"><ahelp hid="modules/scalc/ui/sortoptionspage/leftright"> Sorts columns by the values in the active rows of the selected range.</ahelp></paragraph> </body> </helpdocument>
