Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: update manual description of matches pane #1218

Open
wants to merge 3 commits into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 7 additions & 3 deletions doc_src/en/Dialogs_ProjectProperties.xml
Original file line number Diff line number Diff line change
Expand Up @@ -125,9 +125,13 @@
<para>Switching from <emphasis role="bold">sentence</emphasis> to
<emphasis role="bold">paragraph</emphasis> segmentation
mid-translation may force OmegaT to upgrade old translation memories
that did not use sentence segmentation, but not vice versa. However,
OmegaT will attempt to create fuzzy matches for paragraphs by
combining existing sentence translations.</para>
that did not use sentence segmentation, but not vice versa.</para>
<para>OmegaT can also optionally attempt to create fuzzy matches for paragraphs
by assembling existing sentence translations. See <link
linkend="dialog.preferences.tm.matches.paragraph.from.segmented.tmx"
endterm="dialog.preferences.tm.matches.paragraph.from.segmented.tmx.title"/> to enable
that feature.
</para>

<para>If you change the segmentation while translating, you will have
to reload the project for the new segmentation to take effect. This
Expand Down
19 changes: 19 additions & 0 deletions doc_src/en/HowTo_UseTM.xml
Original file line number Diff line number Diff line change
Expand Up @@ -165,6 +165,25 @@
one of its subfolders and the translated data will be immediately be
available for matching purposes.</para>
</listitem>

<listitem>
<para>If you switch to paragraph segmentation in a project that originally used <link
linkend="dialogs.project.properties.options.segmentation"
endterm="dialogs.project.properties.options.segmentation.title"/>,
you can have OmegaT present matches assembled from existing segments by enabling the
<link
linkend="dialog.preferences.tm.matches.paragraph.from.segmented.tmx"
endterm="dialog.preferences.tm.matches.paragraph.from.segmented.tmx.title"/> option in addition to
showing regular fuzzy matches.</para>
<para> OmegaT will try to segment the source text into sentences,
apply fuzzy matching on the segmented memory entries, and then assemble a paragraph from those matches.
The origins of the matches can be multiple files or memories because the assembled paragraph may not exist in the
translation memories.</para>
<para>Refer to the <link linkend="dialog.preferences.segmentation.setup.type"
endterm="dialog.preferences.segmentation.setup.type.title"/> section for more information on
the benefits and drawbacks of the different types of segmentation.
</para>
</listitem>
</itemizedlist>

<section id="how.to.tm.read.and.write">
Expand Down
7 changes: 7 additions & 0 deletions doc_src/en/OmegaT_Preferences.xml
Original file line number Diff line number Diff line change
Expand Up @@ -1482,6 +1482,13 @@ ${filePath}></programlisting></para>
</table>
</listitem>
</varlistentry>
<varlistentry id="dialog.preferences.tm.matches.paragraph.from.segmented.tmx">
<term id="dialog.preferences.tm.matches.paragraph.from.segmented.tmx.title">
<option>Show matches assembled from multiple segments</option></term>
<listitem><para>Enable matches for paragraphs assembled from matches found in segmented
memory entries from a segmented source text in a project that uses paragraph segmentation.</para>
</listitem>
</varlistentry>
</variablelist>
</section>

Expand Down
Loading