manifest.ttl
author František Kučera <franta-hg@frantovo.cz>
Fri, 15 May 2020 20:32:37 +0200
changeset 0 5b261dcb0da8
permissions -rw-r--r--
LV2: modul zesilovače, dle oficiálního příkladu, ale bez závislosti na Pythonu – stačí gcc a make
franta-hg@0
     1
# LV2 plugins are installed in a ``bundle'', a directory with a standard
franta-hg@0
     2
# structure.  Each bundle has a Turtle file named `manifest.ttl` which lists
franta-hg@0
     3
# the contents of the bundle.
franta-hg@0
     4
#
franta-hg@0
     5
# Hosts typically read the manifest of every installed bundle to discover
franta-hg@0
     6
# plugins on start-up, so it should be as small as possible for performance
franta-hg@0
     7
# reasons.  Details that are only useful if the host chooses to load the plugin
franta-hg@0
     8
# are stored in other files and linked to from `manifest.ttl`.
franta-hg@0
     9
#
franta-hg@0
    10
# ==== URIs ====
franta-hg@0
    11
#
franta-hg@0
    12
# LV2 makes use of URIs as globally-unique identifiers for resources.  For
franta-hg@0
    13
# example, the ID of the plugin described here is
franta-hg@0
    14
# `<http://lv2plug.in/plugins/eg-amp>`.  Note that URIs are only used as
franta-hg@0
    15
# identifiers and don't necessarily imply that something can be accessed at
franta-hg@0
    16
# that address on the web (though that may be the case).
franta-hg@0
    17
#
franta-hg@0
    18
# ==== Namespace Prefixes ====
franta-hg@0
    19
#
franta-hg@0
    20
# Turtle files contain many URIs, but prefixes can be defined to improve
franta-hg@0
    21
# readability.  For example, with the `lv2:` prefix below, `lv2:Plugin` can be
franta-hg@0
    22
# written instead of `<http://lv2plug.in/ns/lv2core#Plugin>`.
franta-hg@0
    23
franta-hg@0
    24
@prefix lv2:  <http://lv2plug.in/ns/lv2core#> .
franta-hg@0
    25
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
franta-hg@0
    26
franta-hg@0
    27
# ==== Describing a Plugin ====
franta-hg@0
    28
franta-hg@0
    29
# Turtle files contain a set of ``statements'' which describe resources.
franta-hg@0
    30
# This file contains 3 statements:
franta-hg@0
    31
# [options="header"]
franta-hg@0
    32
# |================================================================
franta-hg@0
    33
# | Subject                             | Predicate    | Object
franta-hg@0
    34
# | <http://lv2plug.in/plugins/eg-amp>  | a            | lv2:Plugin
franta-hg@0
    35
# | <http://lv2plug.in/plugins/eg-amp>  | lv2:binary   | <amp.so>
franta-hg@0
    36
# | <http://lv2plug.in/plugins/eg-amp>  | rdfs:seeAlso | <amp.ttl>
franta-hg@0
    37
# |================================================================
franta-hg@0
    38
franta-hg@0
    39
# Firstly, `<http://lv2plug.in/plugins/eg-amp>` is an LV2 plugin:
franta-hg@0
    40
<http://lv2plug.in/plugins/eg-amp> a lv2:Plugin .
franta-hg@0
    41
franta-hg@0
    42
# The predicate ```a`'' is a Turtle shorthand for `rdf:type`.
franta-hg@0
    43
franta-hg@0
    44
# The binary of that plugin can be found at `<amp.ext>`:
franta-hg@0
    45
<http://lv2plug.in/plugins/eg-amp> lv2:binary <amp.so> .
franta-hg@0
    46
franta-hg@0
    47
# This file is a template; the token `@LIB_EXT@` is replaced by the build
franta-hg@0
    48
# system with the appropriate extension for the current platform before
franta-hg@0
    49
# installation.  For example, in the output `manifest.ttl`, the binary would be
franta-hg@0
    50
# listed as `<amp.so>`.  Relative URIs in manifests are relative to the bundle
franta-hg@0
    51
# directory, so this refers to a binary with the given name in the same
franta-hg@0
    52
# directory as this manifest.
franta-hg@0
    53
franta-hg@0
    54
# Finally, more information about this plugin can be found in `<amp.ttl>`:
franta-hg@0
    55
<http://lv2plug.in/plugins/eg-amp> rdfs:seeAlso <amp.ttl> .
franta-hg@0
    56
franta-hg@0
    57
# ==== Abbreviation ====
franta-hg@0
    58
#
franta-hg@0
    59
# This file shows these statements individually for instructive purposes, but
franta-hg@0
    60
# the subject `<http://lv2plug.in/plugins/eg-amp>` is repetitive.  Turtle
franta-hg@0
    61
# allows the semicolon to be used as a delimiter that repeats the previous
franta-hg@0
    62
# subject.  For example, this manifest would more realistically be written like
franta-hg@0
    63
# so:
franta-hg@0
    64
franta-hg@0
    65
<http://lv2plug.in/plugins/eg-amp>
franta-hg@0
    66
	a lv2:Plugin ;
franta-hg@0
    67
	lv2:binary <amp.so>  ;
franta-hg@0
    68
	rdfs:seeAlso <amp.ttl> .