<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" type="topic" style="task" 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 plug-ins gives you extra functionality that isn't available in default <app>gedit</app> plug-ins, or even the extra plug-ins that are part of the <app>gedit-plugins</app> package. An online list of third-party plug-ins is <link href="https://wiki.gnome.org/Apps/Gedit">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>
    <item><p>Click <gui>Close</gui>.</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, select <guiseq><gui>View</gui><gui>Show Hidden Files</gui></guiseq>, or press <keyseq><key>Ctrl</key><key>H</key></keyseq>.</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>
