From ba429d344132c088177e853cce8ff7181570b221 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Wed, 10 Apr 2024 19:42:51 +0200 Subject: Adding upstream version 44.2. Signed-off-by: Daniel Baumann --- help/C/figures/gedit-html-snippet.png | Bin 0 -> 3139 bytes help/C/figures/gedit-icon.png | Bin 0 -> 815 bytes help/C/figures/gedit3-screenshot.png | Bin 0 -> 14022 bytes help/C/gedit-brief-intro.page | 30 +++++ help/C/gedit-change-color-scheme.page | 46 +++++++ help/C/gedit-change-default-font.page | 32 +++++ help/C/gedit-close-file.page | 21 ++++ help/C/gedit-create-new-file.page | 22 ++++ help/C/gedit-edit-as-root.page | 37 ++++++ help/C/gedit-files-basic.page | 15 +++ help/C/gedit-full-screen.page | 46 +++++++ help/C/gedit-general-intro.page | 97 +++++++++++++++ help/C/gedit-open-file.page | 26 ++++ help/C/gedit-open-files-from-sidepane.page | 63 ++++++++++ help/C/gedit-open-on-server.page | 46 +++++++ help/C/gedit-open-recent.page | 27 ++++ help/C/gedit-open-several-files-at-once.page | 30 +++++ help/C/gedit-plugin-guide.page | 41 +++++++ help/C/gedit-plugins-change-case.page | 44 +++++++ help/C/gedit-plugins-doc-stats.page | 34 ++++++ help/C/gedit-plugins-external-tools.page | 37 ++++++ help/C/gedit-plugins-file-browser.page | 39 ++++++ help/C/gedit-plugins-insert-date-time.page | 39 ++++++ help/C/gedit-plugins-install.page | 55 +++++++++ help/C/gedit-plugins-modelines.page | 91 ++++++++++++++ help/C/gedit-plugins-pyconsole.page | 24 ++++ help/C/gedit-plugins-quick-open.page | 54 ++++++++ help/C/gedit-plugins-snippets.page | 176 +++++++++++++++++++++++++++ help/C/gedit-plugins-sort.page | 74 +++++++++++ help/C/gedit-printing-order.page | 58 +++++++++ help/C/gedit-printing-select.page | 32 +++++ help/C/gedit-printing.page | 116 ++++++++++++++++++ help/C/gedit-save-file.page | 20 +++ help/C/gedit-search-and-replace.page | 122 +++++++++++++++++++ help/C/gedit-search.page | 44 +++++++ help/C/gedit-spellcheck.page | 117 ++++++++++++++++++ help/C/gedit-syntax-highlighting.page | 27 ++++ help/C/gedit-tab-groups.page | 53 ++++++++ help/C/gedit-tabs.page | 98 +++++++++++++++ help/C/gedit-undo-redo.page | 22 ++++ help/C/index.page | 33 +++++ 41 files changed, 1988 insertions(+) create mode 100644 help/C/figures/gedit-html-snippet.png create mode 100644 help/C/figures/gedit-icon.png create mode 100644 help/C/figures/gedit3-screenshot.png create mode 100644 help/C/gedit-brief-intro.page create mode 100644 help/C/gedit-change-color-scheme.page create mode 100644 help/C/gedit-change-default-font.page create mode 100644 help/C/gedit-close-file.page create mode 100644 help/C/gedit-create-new-file.page create mode 100644 help/C/gedit-edit-as-root.page create mode 100644 help/C/gedit-files-basic.page create mode 100644 help/C/gedit-full-screen.page create mode 100644 help/C/gedit-general-intro.page create mode 100644 help/C/gedit-open-file.page create mode 100644 help/C/gedit-open-files-from-sidepane.page create mode 100644 help/C/gedit-open-on-server.page create mode 100644 help/C/gedit-open-recent.page create mode 100644 help/C/gedit-open-several-files-at-once.page create mode 100644 help/C/gedit-plugin-guide.page create mode 100644 help/C/gedit-plugins-change-case.page create mode 100644 help/C/gedit-plugins-doc-stats.page create mode 100644 help/C/gedit-plugins-external-tools.page create mode 100644 help/C/gedit-plugins-file-browser.page create mode 100644 help/C/gedit-plugins-insert-date-time.page create mode 100644 help/C/gedit-plugins-install.page create mode 100644 help/C/gedit-plugins-modelines.page create mode 100644 help/C/gedit-plugins-pyconsole.page create mode 100644 help/C/gedit-plugins-quick-open.page create mode 100644 help/C/gedit-plugins-snippets.page create mode 100644 help/C/gedit-plugins-sort.page create mode 100644 help/C/gedit-printing-order.page create mode 100644 help/C/gedit-printing-select.page create mode 100644 help/C/gedit-printing.page create mode 100644 help/C/gedit-save-file.page create mode 100644 help/C/gedit-search-and-replace.page create mode 100644 help/C/gedit-search.page create mode 100644 help/C/gedit-spellcheck.page create mode 100644 help/C/gedit-syntax-highlighting.page create mode 100644 help/C/gedit-tab-groups.page create mode 100644 help/C/gedit-tabs.page create mode 100644 help/C/gedit-undo-redo.page create mode 100644 help/C/index.page (limited to 'help/C') diff --git a/help/C/figures/gedit-html-snippet.png b/help/C/figures/gedit-html-snippet.png new file mode 100644 index 0000000..5c11e65 Binary files /dev/null and b/help/C/figures/gedit-html-snippet.png differ diff --git a/help/C/figures/gedit-icon.png b/help/C/figures/gedit-icon.png new file mode 100644 index 0000000..fb37579 Binary files /dev/null and b/help/C/figures/gedit-icon.png differ diff --git a/help/C/figures/gedit3-screenshot.png b/help/C/figures/gedit3-screenshot.png new file mode 100644 index 0000000..81d54ee Binary files /dev/null and b/help/C/figures/gedit3-screenshot.png differ diff --git a/help/C/gedit-brief-intro.page b/help/C/gedit-brief-intro.page new file mode 100644 index 0000000..86658b1 --- /dev/null +++ b/help/C/gedit-brief-intro.page @@ -0,0 +1,30 @@ + + + + + + + A brief introduction to gedit + +

+ gedit is an easy-to-use and general-purpose text editor. Its + development started in 1998, at the beginnings of the + GNOME project, with a good + integration with that desktop environment. +

+ +

+ You can use it to write simple notes and documents, or you can enable more + advanced features that are useful for software development. +

+ + + +

+ Once gedit launches, you can start writing right away. To save + your text, just click the Save button in the gedit + header bar. +

+ diff --git a/help/C/gedit-change-color-scheme.page b/help/C/gedit-change-color-scheme.page new file mode 100644 index 0000000..ab3c9e2 --- /dev/null +++ b/help/C/gedit-change-color-scheme.page @@ -0,0 +1,46 @@ + + + + + Change the text and background colors in gedit. + + + Change the color scheme + +

gedit includes several different color schemes, allowing you to + change the appearance of the main text window.

+ + + To change the color scheme: + +

Press the menu button in the top-right corner of the window and select + PreferencesFont & + Colors.

+ + +

Choose your desired color scheme.

+ + + +

The new color scheme will be applied immediately.

+ +
+ Use a Custom Color Scheme + + +

You can also use color schemes that have been created by others, or + create and use your own color schemes.

+ +

Instructions on how to install custom color schemes, as well as examples + of color schemes that you can download and use, are available on the + gedit + wiki.

+
+ + diff --git a/help/C/gedit-change-default-font.page b/help/C/gedit-change-default-font.page new file mode 100644 index 0000000..19f38ae --- /dev/null +++ b/help/C/gedit-change-default-font.page @@ -0,0 +1,32 @@ + + + + Use a custom font for your text in gedit. + + + Change the default font + +

gedit will use the system fixed-width font by default, + but you can change the default gedit font to suit your preferences. +

+ + + To change the default font in <app>gedit</app>: + +

Press the menu button in the top-right corner of the window and + select PreferencesFont & + Colors.

 +

Uncheck the box next to the phrase, "Use the system fixed width + font."

 +

Click on the current font name. gedit will open + a font-chooser window, allowing you to see available fonts and choose the + one that you prefer.

 +

After you have chosen a new font, use the slider + under the list of fonts to set the default font size.

 +

Click Select, and then close the dialog.

+ + + + diff --git a/help/C/gedit-close-file.page b/help/C/gedit-close-file.page new file mode 100644 index 0000000..89161d1 --- /dev/null +++ b/help/C/gedit-close-file.page @@ -0,0 +1,21 @@ + + + + + Exit from the file you are using. + + + Close a file + +

+ To close a file in gedit, click the × + button that appears on the tab title. Note that when only a single file is + open in a window, you can close the window instead. +

+

+ If your file contains changes that have not been saved, gedit + will prompt you to save those changes before closing the file. +

+ diff --git a/help/C/gedit-create-new-file.page b/help/C/gedit-create-new-file.page new file mode 100644 index 0000000..3448d36 --- /dev/null +++ b/help/C/gedit-create-new-file.page @@ -0,0 +1,22 @@ + + + + + Open a new file for editing. + + + Create a new file + +

+ The easiest way to create a new file in gedit is to click the + + button (the Create a new document button) on the + left side of the header bar. +

+

+ The new file will appear as a new tab inside the same gedit + window. +

+ diff --git a/help/C/gedit-edit-as-root.page b/help/C/gedit-edit-as-root.page new file mode 100644 index 0000000..9cbec61 --- /dev/null +++ b/help/C/gedit-edit-as-root.page @@ -0,0 +1,37 @@ + + + + + Use administrative privileges to edit a file. + + + Edit a file as the root user + + +

Editing files as the root user is potentially dangerous, and may break + your system in bad ways. Take great care when editing files as the root + user.

+ + +

To edit files as the root user, launch gedit from the terminal + by entering:

+ sudo gedit + +

Using the sudo command, you will need to successfully enter + your password before gedit will open.

+ +

As an alternative to the sudo command, you may obtain + administrative privileges by entering:

+ su - + +

You would then launch gedit using the gedit + command.

+ + +

Once you have opened gedit with administrative privileges, + gedit will keep those privileges until you close it.

+ + + diff --git a/help/C/gedit-files-basic.page b/help/C/gedit-files-basic.page new file mode 100644 index 0000000..9faf235 --- /dev/null +++ b/help/C/gedit-files-basic.page @@ -0,0 +1,15 @@ + + + + + Learn the basics of how to work with files in gedit. + + + File basics: Open, close, and save files + +

If you are new to gedit, these topics will help you with + creating, saving, opening and closing files.

+ + diff --git a/help/C/gedit-full-screen.page b/help/C/gedit-full-screen.page new file mode 100644 index 0000000..eb372a8 --- /dev/null +++ b/help/C/gedit-full-screen.page @@ -0,0 +1,46 @@ + + + + + Set gedit to use the entire screen. + + + Use fullscreen mode + +

When working with a large document, you may find it helpful to work in + gedit's fullscreen mode. Using fullscreen mode will hide the + menu bar, tab bar and the tool bar, + presenting you with more of your text and allowing you to better focus on + your tasks.

+ +
+ Turn on fullscreen mode +

To turn on fullscreen mode, press F11. gedit's + menu, title, and tab-bars will hide, and you will only be presented with + the text of your current file.

+

If you need to perform an action from the gedit menu while + working in fullscreen mode, move your mouse pointer to the top of the + screen. The gedit menu bar will reappear, and you can select + your desired action.

+ + +

To switch between open tabs while in fullscreen mode, press either + CtrlAltPgUp or + CtrlAltPgDn.

+ + +
+ +
+ Turn off fullscreen mode +

To turn off fullscreen mode and return to the standard gedit + window, press F11.

+

You can also move your mouse cursor to the top of the screen, and wait + for the menu bar to appear. When the menu bar + appears, select the Leave Fullscreen button.

+
+ + diff --git a/help/C/gedit-general-intro.page b/help/C/gedit-general-intro.page new file mode 100644 index 0000000..1f7f2b2 --- /dev/null +++ b/help/C/gedit-general-intro.page @@ -0,0 +1,97 @@ + + + + + + + Introduction to text editors in general + +
+ Not a word processor +

+ A text editor must be differentiated from + word processors. +

+

+ An example of a word processor is + LibreOffice Writer, which + is released as Free and open-source software. +

+

+ A word processor permits to create different kinds of documents (reports, + letters, books, etc), with the ability to insert images, tables and other + elements. +

+

+ A text editor like gedit is used for creating and editing + text files. The files that are saved by gedit and + stored on disk contain only text. +

+
+ +
+ Text file formats +

+ With a text editor, you can write simple notes as free-form text. But the + text can also follow a certain format. +

+

+ Other programs take text files as input, read the text in it, and produce + a result. For example, web browsers can read text files that follow the + HTML format and renders them as pages. +

+

+ A text file format specifies how the content needs to be structured in + order to be understood by the other programs. +

+
+ +
+ Examples + +
+ Writing documents +

+ It is interesting to note that, with a simple text editor and text + files, it is possible to write documents such as produced by a word + processor. +

+

+ To take our earlier example with HTML, to insert an image, it is done by + referring to an external image file (for example stored on disk in the + same directory). Although the image file is not part of the HTML file, a + web browser knows that it needs to embed it in the page. +

+
+ +
+ Source code +

+ Text files are not restricted to write notes or documents, another area + is writing source code, to develop a piece of software with a + programming or scripting language. +

+
+
+ +
+ Syntax highlighting +

+ When writing text in a certain format (or “language”), it is very useful + to visually distinguish the different kinds of elements, when a portion of + text has a special meaning. The special meanings depend on the + syntax of the language, i.e., how things should be structured. +

+

+ This is done by adding colors to the text (or other highlighting means: + bold, italic, underline, etc). +

+

+ It is important to note that these colors are not saved into the + file; instead, it is the text editor application that presents the text to + the user that way. +

+
+ diff --git a/help/C/gedit-open-file.page b/help/C/gedit-open-file.page new file mode 100644 index 0000000..4828c71 --- /dev/null +++ b/help/C/gedit-open-file.page @@ -0,0 +1,26 @@ + + + + + + Open a file to start working on it. + + + Open a file + +

+ To open a file in gedit, click the Open button. +

+

+ This will cause the Open dialog to appear. Use your mouse or + keyboard to select the file that you wish to open, and then click + Open. +

+

+ To close the Open dialog without opening a file, click + Cancel. +

+ diff --git a/help/C/gedit-open-files-from-sidepane.page b/help/C/gedit-open-files-from-sidepane.page new file mode 100644 index 0000000..b1c8e33 --- /dev/null +++ b/help/C/gedit-open-files-from-sidepane.page @@ -0,0 +1,63 @@ + + + + + Use gedit's side pane as a file browser. + + + View and open files from the side panel +

+ The most common way to switch between files in gedit is by using + the tabs at the top of the gedit window. In some cases, though, + particularly when you are working with a large number of open files, you + may find it easier to use the side panel. +

+ +

+ To activate the side panel, select View + Side Panel, or just press the F9 key. +

+ + +

+ You can toggle the side panel open or closed by pressing + F9 at any time. +

+ + + +
+ Opening files from the side panel +

+ To open files from the side panel, first open the + side panel by selecting View + Side Panel (or just press + F9), and then choose File Browser from the dropdown + at the top of the panel. +

+ +

+ This will activate the File Browser mode of the + side panel. You can then use the navigation buttons at the top + of the panel to locate and open your desired files. +

+
+ +
+ Using the side panel to switch between open files +

+ Once you have several files open, you can use the side panel to switch + between open files. To list open files, choose Documents + from the dropdown at the top of the panel. +

+ +

+ Clicking on any file name in the side panel will open that file + for editing. +

+
+ + diff --git a/help/C/gedit-open-on-server.page b/help/C/gedit-open-on-server.page new file mode 100644 index 0000000..a3d05a1 --- /dev/null +++ b/help/C/gedit-open-on-server.page @@ -0,0 +1,46 @@ + + + + + Access files that are stored on a different computer. + + + Open a file that is located on a server + +

Prior to opening a file on a server from within gedit, you need + to know some technical information about the server. For example, you will + need to know the IP Address or URL of the server, and may need to know what + kind of server it is (e.g., HTTP, FTP, etc.).

+ +

Also, some types of servers impose restrictions on what you can do with + files stored on the server. For example, you may be able to open a file from + a server, but may need to save any changes to the file locally, on your own + computer.

+ +

With these caveats in mind, perform the following steps to open a file + from a server using gedit:

+ + +

In the header bar, click on Open.

 +

Click Other Locations.

 +

Enter the IP Address or URL of the appropriate + server.

 +

Find and select the file that you wish to open.

 +

Use the Character Encoding drop-down list to select the + appropriate character coding.

 +

Click Open.

 + + +

Valid types of URI include http:, ftp:, file:, and all of the methods + supported by GVfs.

+ + +

Files from some types of URI are opened as read-only, and any changes + you make must be saved to a different location. For example, HTTP only + allows files to be read. Files opened from FTP are read-only because not + all FTP servers may correctly work with saving remote files.

+ + + diff --git a/help/C/gedit-open-recent.page b/help/C/gedit-open-recent.page new file mode 100644 index 0000000..62af948 --- /dev/null +++ b/help/C/gedit-open-recent.page @@ -0,0 +1,27 @@ + + + + + Access files that you have previously opened in gedit. + + + Reopen a recently-used file + +

gedit provides easy access to your ten most recently-used + files, that have been previously opened in gedit. Here is how you + can open a recently-used file:

+ +

Click the arrow button next to the Open button in the + header bar.

 +

gedit will display a menu with the ten most + recently-used files.

 +

Select the desired file, and it will open in a new tab.

 + + +

When hovering with the mouse over a recently-used file from the + menu, the full path to the file is displayed in the status bar at the bottom + of the gedit window.

 + + diff --git a/help/C/gedit-open-several-files-at-once.page b/help/C/gedit-open-several-files-at-once.page new file mode 100644 index 0000000..ceb5404 --- /dev/null +++ b/help/C/gedit-open-several-files-at-once.page @@ -0,0 +1,30 @@ + + + + + + Select a set of files to open. + + + Open several files at once +

+ Click the Open button. This will cause the Open dialog + to appear. +

+

+ From the Open dialog, you can select more than one file with + the Ctrl or Shift key. +

+

+ If you hold down the Ctrl key while you select a file, that + file will be added to the selection. +

+

+ If you hold down the Shift key while you select a file, the + selection of files will contain the first file, the last file, and all of + the files in between. +

+ diff --git a/help/C/gedit-plugin-guide.page b/help/C/gedit-plugin-guide.page new file mode 100644 index 0000000..8d42c18 --- /dev/null +++ b/help/C/gedit-plugin-guide.page @@ -0,0 +1,41 @@ + + + + + Use plugins to customize how gedit works for you. + + + Configure and use gedit plugins +

You can do more with gedit by using plugins. Several plugins + are installed by default, but a large number of other plugins are available + separately.

+ +

Many Linux distributions make a group of these plugins available as + a gedit-plugins package. Install the gedit-plugins + package to make these extra plugins available to gedit.

+ + + +

Install gedit-plugins

+ + + + +
+ Default gedit Plugins +
+ +
+ Additional gedit Plugins +
+ + + diff --git a/help/C/gedit-plugins-change-case.page b/help/C/gedit-plugins-change-case.page new file mode 100644 index 0000000..52dddb5 --- /dev/null +++ b/help/C/gedit-plugins-change-case.page @@ -0,0 +1,44 @@ + + + + + Change the case of selected text. + + +Change case + +

This plugin helps you to change the case of selected portions of text. You + can use it to change text to be all lower case, all upper case, to invert the + case, or apply title case. To enable this plugin, select + geditPreferences + PluginsChange Case.

+ +

Once the Change Case plugin is enabled, you can use it by + completing the following steps:

+ + +

Highlight the portion of text that you want to change.

 +

Select geditChange Case

+ +

Choose your desired text-formatting option.

 + + +

The updates to the text formatting will take place immediately.

+ + +

The Invert Case option will convert all lower case letters to + upper case, and will convert all upper case letters to lower case.

+

The Title Case option will convert the first letter of each + word to upper case. All other letters will be converted to lower + case.

+ + + +

If you have not highlighted any text, the Change Case feature + will be grayed-out. You need to select a portion of text before you use the + Change Case feature.

+ + + diff --git a/help/C/gedit-plugins-doc-stats.page b/help/C/gedit-plugins-doc-stats.page new file mode 100644 index 0000000..290eaf0 --- /dev/null +++ b/help/C/gedit-plugins-doc-stats.page @@ -0,0 +1,34 @@ + + + + + View document statistics. + + +Document statistics + +

The Document Statistics plugin shows you various statistics about + your current document. To enable this plugin, select + geditPreferences + PluginsDocument Statistics.

+ +
+ Using Document Statistics + +

Once the plugin is enabled, use it by selecting Tools + Document Statistics. A window will display the + statistical information of your document, including the number of words, + lines, characters, non-space characters, and the size of your file in + bytes.

+ +

You can also use Document Statistics to show you information about + just a portion of your document. To do this, use the mouse pointer to select + the portion of text that you want to examine, and then select + ToolsDocument Statistics. + Gedit will display information for both your entire document, and + for the portion of text that you highlighted.

+
+ + diff --git a/help/C/gedit-plugins-external-tools.page b/help/C/gedit-plugins-external-tools.page new file mode 100644 index 0000000..4d87f9c --- /dev/null +++ b/help/C/gedit-plugins-external-tools.page @@ -0,0 +1,37 @@ + + + + + + + Run scripts on your current files, and interact with other applications. + + + +External tools + +

The External Tools plugin can help simplify repetitive tasks. + Specifically, it extends gedit by helping you to run scripts on + your working files, and by allowing gedit to interact with other + programs on your computer. To enable the External Tools plugin, + select gedit + PreferencesPlugins + External Tools.

+ +
+ Configure the external tools plugin + +

Once you have enabled the plugin, you will need to configure it to suit + your needs. The configuration options are available by selecting + ToolsManage External Tools.

+ + +

This plugin is for advanced users, and requires knowledge of scripting + to be used effectively. Use this plugin with care, as mistakes with your + scripts can affect your work in unintended ways.

+ +
+ + diff --git a/help/C/gedit-plugins-file-browser.page b/help/C/gedit-plugins-file-browser.page new file mode 100644 index 0000000..e4b9362 --- /dev/null +++ b/help/C/gedit-plugins-file-browser.page @@ -0,0 +1,39 @@ + + + + + Use the side panel to browse and open files. + + +File browser panel + +

Depending on how you use gedit, you may find it helpful to use + the File Browser panel plugin. This plugin embeds a + file browser in the side panel, giving you easy access to your + frequently-used files.

+ +

You can enable the side panel by selecting + geditPreferences + PluginsFile Browser Panel.

+ +
+ Opening files from the side panel +

+ To open files from the side panel, first open the + side panel by selecting View + Side Panel (or just press + F9), and then choose File Browser from the dropdown + at the top of the panel. +

+ +

+ This will activate the File Browser mode of the + side panel. You can then use the navigation buttons at the top + of the panel to locate and open your desired files. +

+
+ + diff --git a/help/C/gedit-plugins-insert-date-time.page b/help/C/gedit-plugins-insert-date-time.page new file mode 100644 index 0000000..e86e617 --- /dev/null +++ b/help/C/gedit-plugins-insert-date-time.page @@ -0,0 +1,39 @@ + + + + + Insert the current date/time at the cursor position. + + +Insert date/time + +

As this name of this plugin suggests, the Insert Date/Time + plugin allows you to insert the date and/or time at the current cursor + position.

+ + + To enable the plugin: + +

Press the menu button in the top-right corner of the window and select + Preferences + Plugins.

+ + +

Select Insert Date/Time to enable the plugin.

+ + + +

To use the plugin, press the menu button in the top-right corner of the + window and select Tools + Insert Date and Time….

+ +

By default, the Insert Date/Time plugin will prompt you to + choose your preferred date/time format each time that you use the plugin. + However, you can choose your own default date and time format by pressing the + menu button in the top-right corner of the window and selecting + PreferencesPlugins + Insert Date/TimePreferences.

+ + diff --git a/help/C/gedit-plugins-install.page b/help/C/gedit-plugins-install.page new file mode 100644 index 0000000..b76ba6a --- /dev/null +++ b/help/C/gedit-plugins-install.page @@ -0,0 +1,55 @@ + + + + How to install third-party plugins. + + + Additional gedit plugins + +

Installing third-party plugins gives you extra functionality that isn't + available in default gedit plugins, or even the extra plugins that + are part of the gedit-plugins package. An online list of + third-party plugins is + kept here. +

+ +

Installing a third-party plugin involves downloading the plugin, placing + the plugin files in the right directory, and activating the plugin.

+ + +

You can usually download a plugin from the plugin's website, but + may need to use a revision-control program like git, + bazaar, or subversion to copy a plugin's software + repository from the internet. Refer to the plugin's documentation for + information on getting the plugin.

 +

Place the plugin files into the + /home/username/.local/share/gedit/plugins directory. +

+

Of course, replace the word username with your own username. +

+

After you have placed the plugin files into the correct directory, + the plugin will appear in the Preferences menu. Press the menu button in the + top-right corner of the window and select + PreferencesPlugins[Name of Plugin] + to enable the plugin.

 +

Click Close.

 + + +

After you have enabled the plugin, it should be available for you to use. +

+ + +

The .local directory is hidden by default. To view it and + other hidden files, select ViewShow Hidden + Files, or press CtrlH. +

+ + + +

If the directory .local/share/gedit/plugins/ is not + present on your system, you will need to create it.

+ + + diff --git a/help/C/gedit-plugins-modelines.page b/help/C/gedit-plugins-modelines.page new file mode 100644 index 0000000..2922148 --- /dev/null +++ b/help/C/gedit-plugins-modelines.page @@ -0,0 +1,91 @@ + + + + + Emacs, Kate and Vim-style modelines support for gedit. + + +Modelines + +

The Modelines plugin allows gedit to analyze the + lines of text at the start and end of a file, and then apply a set of + document preferences to the file. The Modelines plugin supports a + subset of the options used by the Emacs, Kate and + Vim text editors.

+ +

To enable the Modelines plugin, select gedit + PreferencesPluginsModelines.

+ +
+ General Modeline Options +

The following options can be set using gedit modelines:

+ +

Tab width

 +

Indent width

 +

Inserting spaces instead of tabs

 +

Text Wrapping

 +

Right margin width

 + + + +

Preferences set using modelines take precedence over the ones specified + in the preference dialog.

+ +
+ +
+ Emacs Modelines + +

The first two lines of a document are scanned for Emacs + modelines, and gedit supports the following Emacs + modeline options:

+ +

Tab-width

 +

Indent-offset

 +

Indent-tabs-mode

 +

Text auto-wrap

 + +

For more information on Emacs modelines, visit the + GNU Emacs + Manual.

+
+ +
+ Kate Modelines + +

The first and last ten lines a document are scanned for Kate + modelines, and gedit supports the following Kate + modeline options:

+ + +

tab-width

 +

indent-width

 +

space-indent

 +

word-wrap

 +

word-wrap-column

 + + +

For more information about Kate modelines, visit the + Kate website.

+
+ +
+ Vim Modelines +

The first and last three lines a document are scanned for Vim + modelines, and gedit supports the following Vim + modeline options:

+ + +

et (expandtab)

 +

ts (tabstop)

 +

sw (shiftwidth)

 +

wrap

 +

textwidth

 + + +

For more information on Vim modelines, visit the + Vim website.

+
+ diff --git a/help/C/gedit-plugins-pyconsole.page b/help/C/gedit-plugins-pyconsole.page new file mode 100644 index 0000000..7291be9 --- /dev/null +++ b/help/C/gedit-plugins-pyconsole.page @@ -0,0 +1,24 @@ + + + + + Add an interactive Python console to the bottom pane. + + + Python console + +

You can add a Python console to the bottom pane, allowing you to test + Python scripts without leaving gedit. To enable the Python + console, select gedit + PreferencesPlugins + Python Console.

+ +

Once the Python console is enabled, you can open it by selecting + ViewBottom Panel.

+ +

If you have also enabled the Embeded Terminal + plugin, the Python Console will appear as a separate tab in the + bottom pane.

 + diff --git a/help/C/gedit-plugins-quick-open.page b/help/C/gedit-plugins-quick-open.page new file mode 100644 index 0000000..b432961 --- /dev/null +++ b/help/C/gedit-plugins-quick-open.page @@ -0,0 +1,54 @@ + + + + Quickly open a file or set of files. + + + Quick open + +

As the name of this plugin would imply, the Quick Open plugin + helps you to open files more quickly than using the usual ways of opening + files. To enable this plugin, select gedit + PreferencesPluginsQuick Open.

+ +

Once you have enabled the Quick Open plugin you can use it as + follows:

+ + +

Open the Quick Open dialog box by pressing + CtrlAltO, or by selecting + Quick Open….

+

The Quick Open file dialog will appear.

 +

Use your mouse to select the file or files that you want to + open.

+

To select several individual files, hold down your Ctrl key + while you click on the files that you want to open.

+

To select a group of files, click on the first file that you want to + open, hold down the Shift key, and then click on the last file + in the list that you want to open.

 +

Click Open.

 + + +

Quick Open will look for files in:

+ + +

The directory of the currently opened document

 +

The root directory of the + File Browser Panel + plugin

 +

Recent documents which are also shown in the Recent + folder in Files

 +

Directories which you have bookmarked in + Files

 +

Your Desktop directory

 +

Your Home directory

 + + + +

Quick Open displays files in any of the above locations + regardless of whether or not you have opened them previously.

+ + + diff --git a/help/C/gedit-plugins-snippets.page b/help/C/gedit-plugins-snippets.page new file mode 100644 index 0000000..504cdb4 --- /dev/null +++ b/help/C/gedit-plugins-snippets.page @@ -0,0 +1,176 @@ + + + + Use snippets to quickly insert often-used pieces of text. + + + Snippets + +

Snippets provide a convenient way of inserting repetitive + portions of code into your files. For example, an HTML snippet for the + ]]> tag would insert the opening and closing + portions of the tag, as well as fixed places where you can enter image + attributes. This can make writing code easier and faster.

+ +
+ Enable Snippets Plugin + +

To enable the Snippets plugin:

+ + + +

Select gedit + Preferences + Plugins.

+ + +

Select Snippets to enable the + plugin.

+ + +
+ +
+ Browse Snippets + +

To browse available snippets:

+ + +

Select Tools + Manage Snippets.

+ +

Make sure the syntax is set appropriately. The status bar at the + bottom of the gedit window will show the current language + setting. This language setting is what allows gedit to insert the + proper snippets. Gedit will normally detect the language or + syntax of the file that you're using, but sometimes you may need to + set it.

+
+ In this example, the language is set to HTML. + +
+ + + +

Browse the snippets that are available for your language or + syntax.

+ + +
+ +
+ Using Snippets + +

To insert a snippet into your current document:

+ + + +

Type the desired snippet name anywhere in your current document.

+ + +

Press Tab to insert the snippet associated with the input + term.

+ + +
+ +
+ Snippet Example Usage + +

For example, if you have set the syntax to HTML, type + head , and press the Tab key. The text would have + auto completed into a snippet as:

+ + + + + Page Title + ]]> + + +
+ +
+ Adding Snippets + +

You can add new Snippets that work either globally (that is, they are + language agnostic) or only in a particular syntax.

+ + + +

Select Tools + Manage Snippets.

+ + +

From the Manage Snippets sidebar select the desired syntax + and click on the "+" button to list existing snippets for the selected + syntax.

+ +

To add a snippet that works globally (that is, when no particular + syntax or language has been set for the document), select + Global from the Manage Snippets sidebar.

+ + + +

To add a new snippet, click on the "plus" icon in the + Manage Snippets sidebar.

+ + +

Input a name for the new snippet. The name of the snippet can be + different from the snippet you want to add.

+ + +

Under the Activation section, you must + input a term for the Tab trigger: textarea. + You will be using this term to insert your snippet.

+ +

If you wish to insert a snippet with a keyboard shortcut, then + click your mouse pointer on Shortcut key: + textarea and press the desired combination of keys. Once you have + pressed and released the keys, the keyboard shortcut will be set.

+ + + +

Under the textarea for Edit:, input the + desired text for the snippet. You may use ${n} to indicate + variables, where n is replaced with a number that + represents the numerical order of variables included.

+ + + +
+ +
+ New Snippet Example + +

Consider you have created a snippet with the term greetings + in Tab trigger:. The + Edit: textarea contains:

+ + + Hello ${1:wonderful}${2:amazing} world! + ]]> + + +

You can insert this snippet by typing greetings in the + document and pressing the Tab key. The following text snippet + will be inserted:

+ + + Hello wonderfulamazing world!]]> + + +

The words "wonderful" and "amazing" can be retained or deleted depending + on your choice of usage. To do so, press Tab to choose between + "wonderful" and "amazing" and press Del to delete the least + preferred option.

+
+ + + diff --git a/help/C/gedit-plugins-sort.page b/help/C/gedit-plugins-sort.page new file mode 100644 index 0000000..3bd2834 --- /dev/null +++ b/help/C/gedit-plugins-sort.page @@ -0,0 +1,74 @@ + + + + + Sort lines of text into alphabetical order. + + +Sort + +

The Sort plugin arranges selected lines of text into alphabetical + order.

+ +
+ Enable Sort Plugin + +

To enable the Sort plugin:

+ + + +

Select gedit + Preferences + Plugins.

+ + +

Select Sort to enable the plugin.

+ + + +
+ +
+ Using Sort Plugin + +

To use the Sort plugin:

+ + + +

Select the desired lines of text.

+ + +

Select Tools + Sort….

+ + +

The Sort dialog will open, allowing you to choose between + several sorting options:

+ + +

Reverse order will arrange the text in reverse + alphabetical order.

+ + +

Remove duplicates will remove duplicate values from + the list.

+ + +

Ignore case will ignore case sensitivity.

+ +

To have the sort ignore the characters at the start of the + lines, set the first character that should be used for sorting in + the Start at column spin box.

+ + + + + +

To perform the sort operation, click Sort.

+ + +
+ + diff --git a/help/C/gedit-printing-order.page b/help/C/gedit-printing-order.page new file mode 100644 index 0000000..629a0de --- /dev/null +++ b/help/C/gedit-printing-order.page @@ -0,0 +1,58 @@ + + + + + Set the pages to print in a certain order. + + +Getting Copies To Print In The Correct Order + +
+ Reverse + +

Printers usually print the first page first, and the last page last, so + the pages end up in reverse order when you pick them up. To reverse the + order:

+ + + +

Select File + Print.

+ + +

In the General tab of the Print dialog under + Copies, check + Reverse.

+ + + +

The last page will be printed first, and so on.

+
+ +
+ Collate + +

If you are printing more than one copy of the document, the print outs + will be grouped by page number by default. (e.g. The copies of page one come + out, then the copies of page two, etc.) Collating will make each copy come + out with its pages grouped together.

+ +

To Collate:

+ + +

Click File + Print.

+ + +

In the General tab of the Print dialog under + Copies check + Collate.

+ + + + +
+ + diff --git a/help/C/gedit-printing-select.page b/help/C/gedit-printing-select.page new file mode 100644 index 0000000..e5ae33d --- /dev/null +++ b/help/C/gedit-printing-select.page @@ -0,0 +1,32 @@ + + + + + Choose the pages that you want to print. + + + Only print certain pages + +

You can selectively print only certain pages from the document. For + example, if you enter the page numbers "1,3,5-7,9", then only pages 1, 3, + 5, 6, 7 and 9 will be printed. To print pages of your choice:

+ + + +

Select File + Print….

+ + +

In the General tab in the Print dialog choose + Pages from the + Range section.

 + +

Type the numbers of the pages you want to print from the document, + separated by commas. Use a dash to specify a range of pages.

+ + + + + diff --git a/help/C/gedit-printing.page b/help/C/gedit-printing.page new file mode 100644 index 0000000..2e63fb5 --- /dev/null +++ b/help/C/gedit-printing.page @@ -0,0 +1,116 @@ + + + + + Print the files that you create with gedit. + + + Printing documents + + +

Printing with gedit requires that you have connected and + configured your printer. If you have not done this, please consult the + printing help for GNOME.

+ + +

gedit allows you to print both to a file and to paper.

+ + + +
+ Printing To Paper + +

You can print your documents to paper using a local or remote printer. To + print a file:

+ + + +

Select File + Print + General.

+ + +

Select the desired printer from the list of printers available.

+ + +

You can preview the file using Print Preview + and once you are satisfied with the settings, click + Print to send the file to printer.

+ + + +

Additionally, from Page Setup tab: you can choose + Layout and Paper options. As + these settings are available throughout GNOME programs, please + consult + Layout and Paper options + help.

+ +
+ +
+ Print Multiple Copies And Between Specified Ranges + +

You can set Range and + Copies options to help you:

+ +
+ +
+ Printing To File + +

You can also use gedit to print to a file. To print your + document to file of a different format:

+ + + +

Select File + Print + Print to File.

+ + +

Printing is enabled for the following file formats, you may select + from:

+ + +

Portable Document Format (.pdf)

+ + +

PostScript (.ps)

+ + +

Scalable Vector Graphic (.svg)

+ + + + +

To print the document to file, click + Print.

+ + + +
+ + diff --git a/help/C/gedit-save-file.page b/help/C/gedit-save-file.page new file mode 100644 index 0000000..a12af63 --- /dev/null +++ b/help/C/gedit-save-file.page @@ -0,0 +1,20 @@ + + + + + Save your file to work on it later. + + + Save a file +

+ To save a file in gedit, click on the + Save button on the right side of the header bar. +

+

+ For a new file, a dialog will appear, and you can choose the name and + directory where the file will be saved. +

+ diff --git a/help/C/gedit-search-and-replace.page b/help/C/gedit-search-and-replace.page new file mode 100644 index 0000000..dc54561 --- /dev/null +++ b/help/C/gedit-search-and-replace.page @@ -0,0 +1,122 @@ + + + + + Find and replace portions of text in a file. + + + Search and replace + + + +
+ The simple search +

+ To open the search entry field, click on: +

+

+ + Menu Button + Find… + +

+
+ +
+ The search and replace +

+ To open the Find and Replace dialog, click on: +

+

+ + Menu Button + Find and Replace… + +

+
+ +
+ Clear highlight +

+ Usually, the text that you've searched for will remain highlighted in the + document. To remove the highlight, click on: +

+

+ + Menu Button + Clear Highlight + +

+
+ +
+ Tips +

+ If you first select a portion of text in the document, and then start a + simple search or open the Find and Replace dialog, the text you've + selected will appear in the search entry. +

+
+ +
+ Search options +

+ The Find and Replace dialog presents the search options as check boxes. +

+

+ For the simple search, click on the + Magnifying Glass icon in the search entry field. +

+ +

+ Select Match Case to make the search case sensitive. +

+ +

+ Select Match Entire Word Only to search for a specific word + without including fragments of other words. +

+

+ For example, if you searched for the word “and” with this option + selected, the word “and” would be matched, but the words + “sand” and “commander” would not be matched. +

+ +

+ Select Wrap Around to continue at the other end of the + document when going to the next or previous search result. +

+ +
+ +
+ Using escape sequences +

+ In a search or replace entry, you can use escape sequences with + the following meanings: +

+ + + \n +

Newline

+ + + \r +

Carriage return

+ + + \t +

Tab

+ + + \\ +

+ Backslash. If you actually want a backslash and avoid one of the above + special meanings, the backslash needs to be escaped. +

+ + +
+ diff --git a/help/C/gedit-search.page b/help/C/gedit-search.page new file mode 100644 index 0000000..949aef2 --- /dev/null +++ b/help/C/gedit-search.page @@ -0,0 +1,44 @@ + + + + + + + Simple search: additional topics + +
+ Navigate through the search results +

+ There are several ways to go to the next or previous search result. +

+

+ There are up and down + arrows next to the search entry. +

+

+ You can also press the up arrow or down arrow keys + on your keyboard while the search entry is visible. +

+

+ Keyboard shortcuts are also available. +

+
+ +
+ Closing the search entry field +

+ You can close the search entry by pressing different keys: +

+ +

+ Pressing Esc will return the cursor to where it was before + you began your search. +

+

+ Pressing Enter will keep the cursor to its current position. +

+ +
+ diff --git a/help/C/gedit-spellcheck.page b/help/C/gedit-spellcheck.page new file mode 100644 index 0000000..b1b58c4 --- /dev/null +++ b/help/C/gedit-spellcheck.page @@ -0,0 +1,117 @@ + + + + + Check your files for spelling errors. + + + Spell-check your document +
+ Enable the spell checker +

The Spell-check feature is provided as a plugin in gedit which + can be enabled as required. To enable the plugin:

+ + + +

Select gedit + Preferences + Plugins.

+ + +

Select Spell Checker to enable the + plugin.

+ + + +
+ +
+ Spell-check your document + +

To check for misspelt words in your document:

+ + + +

Select Tools + Check Spelling.

+ + + + +

To have gedit automatically highlight misspelt words in your + document as you type, select ToolsHighlight Misspelled Words.

+ +
+ +
+ Using spell-check + +

You can choose the right substitution for misspelt words using the Check + Spelling dialog. The misspelt word being checked by the spell-checker is + displayed in bold style next to Misspelled word:. + You can choose from the following corrective actions:

+ + + +

Change to: allows you to input a word and + use Check Word to check the validity of the + spelling.

+ + +

Suggestions: lists the available + substitutions for the word.

+ + +

Ignore allows you to bypass spell check for + a instance of current word.

+ + +

Ignore All allows you to bypass spell check + for all instances of the current word.

+ + +

Change substitutes the misspelt or + unrecognized word with a chosen substitute from the + Suggestions: list.

+ + +

Change all substitutes all + misspelt or unrecognized words with the chosen substitute from the + Suggestions: list.

+ + +

Add word allows you to add the current word + to the gedit User dictionary. Adding custom words + to the User dictionary will allow gedit to + recognize the word in documents and thus will not be highlighted as a + misspelt word.

+ + + +
+ +
+ Define the language to use for spell checking +

By default, gedit will use your current language to spell + check your document. If you need to use another language, choose + ToolsSet + Language…, then choose the language you want to use.

+
+ +
+ Dictionaries + +

gedit uses + Enchant, + a small system utility, for spell checking. Enchant can use + several different dictionaries to check your spelling. Two such + dictionary back-ends are Hunspell and Aspell.

+ +

If the language you want to use is not available in gedit, + use your computer's software installer or package manager to install the + dictionary back-end that you want.

+
+ diff --git a/help/C/gedit-syntax-highlighting.page b/help/C/gedit-syntax-highlighting.page new file mode 100644 index 0000000..0494e72 --- /dev/null +++ b/help/C/gedit-syntax-highlighting.page @@ -0,0 +1,27 @@ + + + + + Highlight your text to make it easier to read. + + + Turn on syntax highlighting + +
+ Syntax highlighting +

gedit provides syntax highlighting for a wide range of markup, + programming, and scientific languages. If gedit recognizes the + syntax being used when you open a file, it will automatically highlight the + text.

+ +

If your syntax or language is not highlighted upon startup, you can + select the appropriate syntax or language by clicking + View + Highlight Mode, + and then choosing the desired syntax. Alternately, you can select the syntax + name from a list at the bottom of the gedit window.

+
+ + diff --git a/help/C/gedit-tab-groups.page b/help/C/gedit-tab-groups.page new file mode 100644 index 0000000..95964f0 --- /dev/null +++ b/help/C/gedit-tab-groups.page @@ -0,0 +1,53 @@ + + + + + + View several documents side-by-side. + + + Tab groups + +

+ You can view several documents side-by-side inside the same gedit + window by creating a new tab group. +

+ +
+ Managing tab groups +

+ There are several possibilities for managing tab groups. +

+

+ To create a new tab group, you can right-click on a tab title and select + Move to New Tab Group. +

+

+ Keyboard shortcuts are available too. +

+

+ The tab groups will be placed into two panes that can be resized. It is an + horizontal split: the original tab group is on the left, the new tab group + is added on the right. +

+

+ You can open as much tab groups in a gedit window as your + screen allows, but you will have to resize them in order to see them + correctly. +

+
+ +
+ Move a tab to another tab group +

+ You can drag and drop a tab into another tab group. +

+

+ See Drag and drop tabs + for more details. +

+
+ diff --git a/help/C/gedit-tabs.page b/help/C/gedit-tabs.page new file mode 100644 index 0000000..6145613 --- /dev/null +++ b/help/C/gedit-tabs.page @@ -0,0 +1,98 @@ + + + + + + Organize your tabs. + + + Move tabs + +

+ By default, documents are opened in new tabs inside the same + gedit window. +

+ +
+ Move a tab +

+ There are several means to move a tab to another location, to organize the + files you edit in the way you like. +

+

+ You can right-click on a tab title and choose the desired option. +

+

+ Keyboard shortcuts are available too. +

+ +
+ Drag and drop tabs +

+ Another means is to drag and drop a tab: +

+ + +

Click and hold the mouse button on the tab title.

+ + +

Move the tab to the desired location.

+ + +

Release the mouse button.

+ + +
+
+ +
+ Drag and drop locations + +
+ To re-order tabs within the same window +

+ Drag and drop the tab along the tabs titles. +

+
+ +
+ To create a new window from an existing tab +

+ Drag and drop the tab out of the gedit window. +

+

+ When gedit is maximized, drag the tab onto the top bar of + GNOME Shell at the top of the screen. +

+
+ +
+ To move a tab from one gedit window to another +

+ Drag and drop the tab to the other window, either within the text area, + or within the tabs titles to choose the exact location. +

+ + + +
+
+ diff --git a/help/C/gedit-undo-redo.page b/help/C/gedit-undo-redo.page new file mode 100644 index 0000000..a4c5a30 --- /dev/null +++ b/help/C/gedit-undo-redo.page @@ -0,0 +1,22 @@ + + + + + Revert a recent change to one of your files. + + + Undo/redo a recent action + +

If you make a mistake while editing a document in gedit, you can + undo the change by pressing CtrlZ.

+ + +

You cannot undo a change after you have closed a gedit file.

+ + +

To redo the change that was undone, press + CtrlShiftZ.

+ diff --git a/help/C/index.page b/help/C/index.page new file mode 100644 index 0000000..2290760 --- /dev/null +++ b/help/C/index.page @@ -0,0 +1,33 @@ + + + + <media type="image" mime="image/png" src="figures/gedit-icon.png" its:translate="no" /> + gedit + + + + +
+ Working with files + +
+ +
+ Printing with gedit +
+ +
+ More advanced topics +
+ +
+ Configure gedit +
+ +
+ gedit plugins +
+ -- cgit v1.2.3