<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" type="topic" style="task" id="gedit-plugins-external-tools" xml:lang="en_GB">

<!-- TODO: Provide an example or two about using external tools -->

<info>
  <link type="guide" xref="gedit-plugin-guide#gedit-default-plugins"/>
  <desc>Run scripts on your current files, and interact with other applications.</desc>
  <!--INFOAT: https://wiki.gnome.org/Apps/Gedit/Plugins/ExternalTools -->

    <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>External tools</title>

  <p>The <em>External Tools</em> plug-in can help simplify repetitive tasks. Specifically, it extends <app>gedit</app> by helping you to run scripts on your working files, and by allowing <app>gedit</app> to interact with other programs on your computer. To enable the <app>External Tools</app> plug-in, select <guiseq><gui style="menu">gedit</gui> <gui style="menuitem">Preferences</gui><gui>Plug-ins</gui> <gui>External Tools</gui></guiseq>.</p>

  <section id="plugin-config-external-tools">
    <title>Configure the external tools plug-in</title>

  <p>Once you have enabled the plug-in, you will need to configure it to suit your needs. The configuration options are available by selecting <guiseq><gui>Tools</gui><gui>Manage External Tools</gui></guiseq>.</p>
  
  <note style="caution">
    <p>This plug-in is for advanced users, and requires knowledge of scripting to be used effectively. Use this plug-in with care, as mistakes with your scripts can affect your work in unintended ways.</p>
  </note>
  </section>

</page>
