From: Ralf Jung Date: Wed, 14 Oct 2015 20:01:57 +0000 (+0200) Subject: convert README to markdown X-Git-Url: https://git.ralfj.de/zonemaker.git/commitdiff_plain/80ad8ab8737f7e43f12ced20d504a3fa47cf6e10?ds=inline;hp=9aefb642e2410ed4d11f2ca94efd34f0c9e78f8b convert README to markdown --- diff --git a/README.md b/README.md new file mode 100644 index 0000000..7c26f59 --- /dev/null +++ b/README.md @@ -0,0 +1,39 @@ +# zonemaker: Python DNS zone files + +## Introduction + +This is [zonemaker](https://www.ralfj.de/projects/zonemaker), a tool +to generate DNS zone files from Python. + +The plain zone file format is pretty limited. There are not even +variables, so in many cases IP addresses and other data has to be +repeated several times. zonemaker is an attempt to provide more +flexibility, by allowing you to write your zones in Python. Hence all +the usuel fatures, like variables, macros (also known as functions) +and loops, are available to generate DNS zone data. At the same time, +zonemaker is reasonably simple and close to the actual structure of a +DNS zonefile, so it is suited for small setups. The output of +zonemaker is a standard zonefile, it can be used with any DNS server +supporting those. + +## Usage + +Simply call `zonemaker` with the zone python file as argument. The +result will be printed to stdout. See `db.example.com.py` for a sample +file demonstrating the use of the interface. `Makefile.sample` shows +how a makefile which first updates the zone(s), and then tells BIND to +reload, could look like. + +## Source, License + +You can find the sources in the +[git repository](http://www.ralfj.de/git/zonemaker.git) (also +available [on GitHub](https://github.com/RalfJung/zonemaker)). They +are provided under a +[2-clause BSD license](http://opensource.org/licenses/bsd-license.php). See +the file `LICENSE-BSD` for more details. + +## Contact + +If you found a bug, or want to leave a comment, please +[send me a mail](mailto:post-AT-ralfj-DOT-de). diff --git a/README.rst b/README.rst deleted file mode 100644 index b0a3f5b..0000000 --- a/README.rst +++ /dev/null @@ -1,43 +0,0 @@ -zonemaker: Python DNS zone files -================================ - -Introduction ------------- - -This is zonemaker_, a tool to generate DNS zone files from Python. - -The plain zone file format is pretty limited. There are not even variables, so -in many cases IP addresses and other data has to be repeated several times. -zonemaker is an attempt to provide more flexibility, by allowing you to write -your zones in Python. Hence all the usuel fatures, like variables, macros (also -known as functions) and loops, are available to generate DNS zone data. At the -same time, zonemaker is reasonably simple and close to the actual structure of a -DNS zonefile, so it is suited for small setups. The output of zonemaker is a -standard zonefile, it can be used with any DNS server supporting those. - -.. _zonemaker: https://www.ralfj.de/projects/zonemaker - -Usage ------ - -Simply call ``zonemaker`` with the zone python file as argument. The result will -be printed to stdout. See ``db.example.com.py`` for a sample file demonstrating -the use of the interface. ``Makefile.sample`` shows how a makefile which first -updates the zone(s), and then tells BIND to reload, could look like. - -Source, License ---------------- - -You can find the sources in the `git repository`_ (also available `on GitHub`_). -They are provided under a `2-clause BSD license`_. See the file ``LICENSE-BSD`` -for more details. - -.. _git repository: http://www.ralfj.de/git/zonemaker.git -.. _on GitHub: https://github.com/RalfJung/zonemaker -.. _2-clause BSD license: http://opensource.org/licenses/bsd-license.php - -Contact -------- - -If you found a bug, or want to leave a comment, please -`send me a mail `_.