Skip to content
GitLab
Menu
Projects
Groups
Snippets
/
Help
Help
Support
Community forum
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in
Toggle navigation
Menu
Open sidebar
Utilities
Kate
Commits
a94a3781
Commit
a94a3781
authored
Aug 16, 2021
by
Yuri Chornoivan
Browse files
Sync docs with the current ktexteditor framework interface
parent
55a9f4e3
Pipeline
#75234
passed with stage
in 6 minutes and 30 seconds
Changes
1
Pipelines
1
Hide whitespace changes
Inline
Side-by-side
doc/katepart/configuring.docbook
View file @
a94a3781
...
...
@@ -30,8 +30,13 @@ by changing them per document during an editing session.</para>
<sect2 id="appearance">
<title>Appearance</title>
<sect3 id="prefcolors-fonts">
<title>Font</title>
<sect3 id="appearance-general">
<title>General</title>
<variablelist>
<varlistentry>
<term><guilabel>Editor font</guilabel></term>
<listitem>
<para>
Here you can choose the font of the editor text. You can choose from
any font available on your system, and set a default size. A sample text
...
...
@@ -40,98 +45,79 @@ is displayed at the bottom of the dialog, so you can see the effect of your choi
<para>For more information about selecting a font, see the
<ulink url="help:/fundamentals/fonts.html"><emphasis>Choosing Fonts</emphasis>
section of the <emphasis>&kde; Fundamentals</emphasis> documentation</ulink>.</para>
</sect3>
<sect3 id="appearance-general">
<title>General</title>
<variablelist>
<varlistentry>
<term><guilabel>Dynamic Word Wrap</guilabel></term>
<listitem>
<para>If this option is checked, the text lines
will be wrapped at the view border on the screen.</para>
<variablelist>
<varlistentry>
<term><guilabel>Dynamic word wrap indicators (if applicable)</guilabel></term>
<listitem><para>Choose when the Dynamic word wrap indicators
should be displayed, either <guilabel>Off</guilabel>, <guilabel>Follow Line
Numbers</guilabel> or <guilabel>Always on</guilabel>.
</para></listitem></varlistentry>
<varlistentry>
<term><guilabel>Align dynamically wrapped lines
to indentation depth:
</guilabel></term>
<listitem><para>Enables the start of dynamically wrapped
lines to be aligned vertically to the indentation level of the first
line. This can help to make code and markup more
readable.</para><para>Additionally, this allows you to
set a maximum width of the screen, as a percentage,
after which dynamically wrapped lines will no longer be vertically aligned.
For example, at 50%, lines whose indentation levels are deeper than 50% of the
width of the screen will not have vertical alignment applied to subsequent
wrapped lines.</para></listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>
W
hitespace
Highlighting
</guilabel></term>
<term><guilabel>
Show w
hitespace
indicators
</guilabel></term>
<listitem>
<variablelist>
<varlistentry>
<term><guilabel>Highlight tabulators</guilabel></term>
<listitem><para>The editor will display a » symbol to indicate the presence
of a tab in the text.</para></listitem>
<term><guilabel>Never</guilabel></term>
<listitem><para>The editor will never display dots to indicate the presence of whitespace.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>
Highlight trailing spaces
</guilabel></term>
<term><guilabel>
At the end of a line
</guilabel></term>
<listitem><para>The editor will display dots to indicate the presence of extra
whitespace at the end of lines.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>
Highlight marker size
</guilabel></term>
<listitem><para>
Use the slider to change the size of the visible highlight marker
.</para></listitem>
<term><guilabel>
Always
</guilabel></term>
<listitem><para>
The editor will always display dots to indicate the presence of whitespace
.</para></listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Whitespace indicator size</guilabel></term>
<listitem><para>Use the slider to change the size of the visible indicator marker.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Show tab indicators</guilabel></term>
<listitem><para>When checked the editor will display a » symbol to indicate the presence
of a tab in the text.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>
Advanced
<term><guilabel>
Bracket matching
</guilabel></term>
<listitem><para>
<variablelist>
<varlistentry>
<term><guilabel>Show indentation lines
</guilabel></term>
<listitem><para>If this is checked, the editor will display
vertical lines to help identifying indent lines.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Highlight range between selected brackets
</guilabel></term>
<listitem><para>If this is enabled, the range between the selected matching brackets will be highlighted.</para></listitem>
</varlistentry>
</variablelist>
</para></listitem>
<varlistentry>
<term><guilabel>Show preview of matching open bracket
</guilabel></term>
<listitem><para>When enabled, the editor will show a tooltip of the matching open bracket.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>
Animate bracket matching
<term><guilabel>
Flash matching bracket when cursor moves to other bracket in pair
</guilabel></term>
<listitem><para>If enabled, moving on the brackets (<keycap>{</keycap>, <keycap>[</keycap>,
<keycap>]</keycap>, <keycap>}</keycap>,<keycap>(</keycap> or <keycap>)</keycap>) will
quickly
animate
the matching bracket.</para></listitem>
quickly
flash
the matching bracket.</para></listitem>
</varlistentry>
</variablelist>
</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>
Fold first
line
<term><guilabel>
Show indentation
line
s
</guilabel></term>
<listitem><para>If
enabled, the first line is folded, if possible. This is useful,
if the file starts with a comment, such as a copyright
</para></listitem>
<listitem><para>If
this is checked, the editor will display
vertical lines to help identifying indent lines.
</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Show Word Count
<term><guilabel>Counts
</guilabel></term>
<listitem><para>
<variablelist>
<varlistentry>
<term><guilabel>Show word count
</guilabel></term>
<listitem><para>Displays the number of words and characters in the document and
in the current selection in the status bar.
...
...
@@ -144,6 +130,59 @@ This option is also available in the status bar context menu.</para></listitem>
This option is also available in the status bar context menu.</para></listitem>
</varlistentry>
</variablelist>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Fold first line
</guilabel></term>
<listitem><para>If enabled, the first line is folded, if possible. This is useful,
if the file starts with a comment, such as a copyright</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Dynamic Word Wrap</guilabel></term>
<listitem>
<para>If this option is checked, the text lines
will be wrapped at the view border on the screen.</para>
<para>
<variablelist>
<varlistentry>
<term><guilabel>Wrap dynamically at static word wrap marker
</guilabel></term>
<listitem><para>When checked, editor wraps lines dynamically at the <link linkend="pref-word-wrap">static word wrap position</link>.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Disregard word boundaries for dynamic wrapping
</guilabel></term>
<listitem><para>When checked, the editor does not take into account word boundaries when wrapping text lines.</para></listitem>
</varlistentry>
</variablelist>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Dynamic word wrap indicators</guilabel></term>
<listitem><para>Choose when the Dynamic word wrap indicators
should be displayed, either <guilabel>Off</guilabel>, <guilabel>Follow Line
Numbers</guilabel> or <guilabel>Always on</guilabel>.
</para></listitem></varlistentry>
<varlistentry>
<term><guilabel>Align dynamically wrapped lines
to indentation depth:
</guilabel></term>
<listitem><para>Enables the start of dynamically wrapped
lines to be aligned vertically to the indentation level of the first
line. This can help to make code and markup more
readable.</para><para>Additionally, this allows you to
set a maximum width of the screen, as a percentage,
after which dynamically wrapped lines will no longer be vertically aligned.
For example, at 50%, lines whose indentation levels are deeper than 50% of the
width of the screen will not have vertical alignment applied to subsequent
wrapped lines.</para></listitem>
</varlistentry>
</variablelist>
</sect3>
<sect3 id="appearance-borders">
...
...
Write
Preview
Supports
Markdown
0%
Try again
or
attach a new file
.
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment