<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="gedit-plugins-install" xml:lang="en_GB">
  <info>
    <link type="guide" xref="gedit-plugin-guide#gedit-additional-plugins"/>
    <desc>How to install third-party plug-ins.</desc>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Zander Brown</mal:name>
      <mal:email>zbrown@gnome.org</mal:email>
      <mal:years>2020</mal:years>
    </mal:credit>
  </info>

  <title>Additional gedit plug-ins</title>

  <p>Installing third-party plugins gives you extra functionality that isn't
  available in default <app>gedit</app> plugins, or even the extra plugins that
  are part of the <app>gedit-plugins</app> package. An online list of
  third-party plugins is
  <link href="https://gitlab.gnome.org/World/gedit/gedit/-/blob/master/plugins/third-party-plugins.md">kept here</link>.
  </p>

  <p>Installing a third-party plug-in involves downloading the plug-in, placing the plug-in files in the right directory, and activating the plug-in.</p>

  <steps>
    <item><p>You can usually download a plug-in from the plug-in's website, but may need to use a revision-control program like <app>git</app>, <app> bazaar</app>, or <app>subversion</app> to copy a plug-in's software repository from the internet. Refer to the plug-in's documentation for information on getting the plug-in.</p></item>
    <item><p>Place the plug-in files into the <file>/home/<var>username</var>/.local/share/gedit/plugins</file> directory.</p>
    <p>Of course, replace the word <var>username</var> with your own username.</p></item>
    <item><p>After you have placed the plug-in files into the correct directory, the plug-in will appear in the Preferences menu. Press the menu button in the top-right corner of the window and select <guiseq><gui style="menuitem"> Preferences</gui><gui style="tab">Plug-ins</gui><gui>[Name of Plug-in]</gui> </guiseq> to enable the plug-in.</p></item>
  </steps>

  <p>After you have enabled the plug-in, it should be available for you to use.</p>

  <note style="tip"><p>
    The <file>.local</file> directory is hidden by default. To view it and
    other hidden files, you can usually select
    <guiseq><gui>View Options</gui><gui>Show Hidden Files</gui></guiseq> in a
    file manager.
  </p></note>

  <note style="tip">
    <p>If the directory <file>.local/share/gedit/plugins/</file> is not present on your system, you will need to create it.</p>
  </note>
</page>
