[Libreoffice-bugs] [Bug 132643] New: [LOCALHELP] Translate section id to English mnemonics

[bugzilla-daemon at bugs.documentfoundation.org]

https://bugs.documentfoundation.org/show_bug.cgi?id=132643

            Bug ID: 132643
           Summary: [LOCALHELP] Translate section id to English mnemonics
           Product: LibreOffice
           Version: unspecified
          Hardware: All
                OS: All
            Status: UNCONFIRMED
          Severity: minor
          Priority: medium
         Component: Documentation
          Assignee: libreoffice-bugs at lists.freedesktop.org
          Reporter: olivier.hallot at libreoffice.org
                CC: olivier.hallot at libreoffice.org

Many of the legacy section and variable id's in Help files are in German
mnemonics. 

The objective is to translate section's id's to English mnemonics for XML
readability. We leave the change of variables id's for another moment, because
of the impact in translation.

For example, in folder helpcontent2/source/text/smath/

grep -ri \<section *

(....)

main0100.xhp:  <section id="menues">
main0101.xhp:    <section id="datei">
main0102.xhp:  <section id="bearbeiten">
main0103.xhp:<section id="ansicht">
main0105.xhp:  <section id="format">
main0106.xhp:<section id="extras">
main0107.xhp:  <section id="fenster">
main0200.xhp:<section id="symbolleisten">
main0202.xhp:<section id="statusleiste">
main0203.xhp:<section id="werkzeugleiste">
main0503.xhp:<section id="waskann">

The task is extensive, and may require several patches, to ease review. No big
chunk please.

The change should not affect translations.

The patch must ensure that every reference to the new section id must be
corrected too. That requires a search in all helpcontent2/source/text/ folder
to locate and change the reference, which is based on the search for
href="path/to/file#sectionOldId" and change to
href="path/to/file#sectionNewId".

The new section id must be unique in the file. Choose carefully.

A mistake in the reference will produce the sentence "D'oh you found a bug!" in
red in the Help page for embeds and a 404 for links.

Note: modern IDEs can perform a search & replace in the whole project and turn
it easier to make the changes of references. However, refrain to accept the IDE
search results blindly.

*Do not* reformat the whole help file, adding indents or other fancy text
layout.

-- 
You are receiving this mail because:
You are the assignee for the bug.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.freedesktop.org/archives/libreoffice-bugs/attachments/20200503/97e2ecc1/attachment-0001.htm>