Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
tree: d41d16d3ca
Dominic Hopf December 11, 2011
file 72 lines (52 sloc) 2.774 kb
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71
How to get your plugin listed here
==================================

.. contents::

There are different ways to get your plugin listed here. Every possibility
ends with contacting Dominic Hopf. He is the maintainer of this website and
takes care of uploading the HTML files and including new plugins into
navigation and so on.


Note
----

If your plugin already is part of the Geany Plugins project, you should find
your plugin listed here. There is a cronjob running every night, which
updates the plugins.geany.org website with latest information from the
README files of the plugins. For this to work correctly, it is necessary
you have a README file in trunk/geany-plugins/{your plugin name}/ which is
written in restructuredText.

If the README file is there, but still not listed on the plugins.geany.org
website, make sure you gave the cronjob a chance to find your README and
wait a night before contacting Dominic to have a deeper look on the issue.


1st Way
-------

* create a file {your plugin name}.html
* edit the file manually, get inspired by the plugin sites already existing
  and keep an eye on the validity of the HTML code. It should be XHTML 1.1 -
  which is very strict.
* when your HTML file is finished, contact Dominic by mail and send him
  your file. He will do the rest for you.


2nd Way
-------

This one will only work, if you write your README file in restructuredText
as some other plugin authors do. You will need to use two tools: rst2html
and HTML Tidy. Dominic wrote some configuration files for use with those
tools. If you do not have them yet, feel free to contact Dominic to get
them. The result should be an almost perfect HTML file which can be
included into the plugins.geany.org website. Do this steps to generate the
file:

    rst2html --config=rst2html_config.conf README > {your plugin name}.html
    tidy -config tidy.conf {your plugin name}.html


While {your plugin name} is the actual UNIX name (lowercase!) of your plugin.
Note: There is no need for HTML headers and body and so on. Those will be
provided by the website itself. Your HTML file should just provide pure
XHTML 1.1 validating content, it will appear within the body tags on the
plugins.geany.org website.

When you're done, have a look if your HTML file looks good (get some
inspiration from already existing plugin sites) and send it to Dominic then.


Contact
-------

The website plugins.geany.org is currently maintained by `Dominic Hopf
<http://dominichopf.de>`_. His mail address is dmaphy@googlemail.com. If
you have any questions concerning this site, please consider to contact him
first of all. If it takes too long for an answer, feel free to kick his
butt at the `#geany <irc://chat.freenode.net/geany>`_ IRC channel on
chat.freenode.net.
Something went wrong with that request. Please try again.