From d38c4094a1aef8be93218adeefe66b20308d96e3 Mon Sep 17 00:00:00 2001
From: David Robillard <d@drobilla.net>
Date: Fri, 21 Nov 2014 01:12:26 -0500
Subject: Initial website Markdown conversion.

---
 content/pages/developer-information.md | 77 ++++++++++++++++++++++++++++++++++
 1 file changed, 77 insertions(+)
 create mode 100644 content/pages/developer-information.md

(limited to 'content/pages/developer-information.md')

diff --git a/content/pages/developer-information.md b/content/pages/developer-information.md
new file mode 100644
index 0000000..dde7b49
--- /dev/null
+++ b/content/pages/developer-information.md
@@ -0,0 +1,77 @@
+Title: Developer Information
+
+The way to learn about implementing LV2 is by example.  The documentation and
+example projects listed below have been created specifically for this purpose,
+look at these first.  Copying an example as a template is recommended.
+
+
+## What *not* to do 
+
+If you are interested in implementing LV2, do *not* look at the specifications
+and API references first!  They are just that: references, and do not provide a
+high-level view of how to get the job done.  Once you have a basic working
+implementation based on the examples, if you need more specific detail, then
+the references are useful.
+
+
+## Implementing Plugins
+
+LV2 includes several example plugins which are simple demonstrations of various
+types of plugins and the features they require with thorough documentation.  If
+you prefer to read source code, they are in the `plugins` directory of the LV2
+distribution.
+
+If you would prefer to read a document, there is also a "book" generated from
+the literate source code of these plugins:
+
+* [Programming LV2 Plugins](http://lv2plug.in/book)
+
+
+## Implementing Hosts
+
+LV2 hosts use a library to handle all the details of plugin discovery,
+investigation, and instantiation.  [Lilv](http://drobilla.net/software/lilv) is
+the standard library for this.
+
+* [Lilv API Reference](http://drobilla.net/docs/lilv/)
+
+Plans are currently underway to incorporate simple and thoroughly documented hosts into LV2, along the lines of the plugin
+examples.  Until then, several external projects serve as useful examples:
+
+* [lv2file](https://github.com/jeremysalwen/lv2file) is a very simple
+  single-file program that applies an LV2 plugin to an audio file.
+
+* [Jalv](http://drobilla.net/software/jalv) is a relatively simple yet
+  fully-featured [Jack](http://jackaudio.org) host for LV2 plugins.  Start at
+  the core, [jalv.c](http://dev.drobilla.net/browser/trunk/jalv/src/jalv.c),
+  which weighs in at just under 1000 SLOC.  Jalv also supports MIDI, embedded
+  GUIs, presets, state saving, and other features.
+
+
+## Reference
+
+Most LV2 specifications have two parts: code and data.  The "specification"
+documentation comes from the data, and documents the various concepts in the
+specification, with links to the API reference of the associated APIs.  After
+examples, this is the best place to better understand an extension.
+
+The API reference is generated from Doxygen, and serves the usual purpose.  Go
+there for documentation about a specific function, struct, or define.
+
+* [Specifications](http://lv2plug.in/ns)
+
+* [API Reference](http://lv2plug.in/doc/html)
+
+
+## Help
+
+If you have any trouble or questions in general, ask on the
+[mailing list](http://lists.lv2plug.in/listinfo.cgi/devel-lv2plug.in), or visit
+us in [#lv2](http://webchat.freenode.net/?channels=lv2) on irc.freenode.net
+
+
+## Other Resources
+
+* [Logo](http://lv2plug.in/logo)
+
+* [LV2 Achievement of GMPI Requirements](http://lv2plug.in/gmpi.html)
-- 
cgit v1.2.1