# RDFtk: Names
This crate provides a set of modules that contain the `IRI`s and `QName` strings for commonly used vocabularies. It also provides macro support for defining new namespaces in the same style as this library.
[](https://crates.io/crates/rdftk_names)
[](https://docs.rs/rdftk_names)
## Vocabularies
Te following table shows the set of namespaces supported, those with "TBD" in the module column are yet to be encoded.
| Module | Vocabulary | Namespace |
|------------------|------------|-----------|
| `dt::dcam` | [DCMI Abstract Model](https://www.dublincore.org/specifications/dublin-core/abstract-model/) | `http://purl.org/dc/dcam/` |
| `dt::dcmi_types` | [DCMI Type Vocabulary](https://www.dublincore.org/specifications/dublin-core/dcmi-type-vocabulary/) | `http://purl.org/dc/dcmitype/` |
| `dt::elements`' | [DCMI Terms](https://www.dublincore.org/specifications/dublin-core/dcmi-terms/) | `http://purl.org/dc/elements/1.1/` |
| `dt::terms` | [DCMI Terms](https://www.dublincore.org/specifications/dublin-core/dcmi-terms/) legacy elements | `http://purl.org/dc/terms/` |
| `foaf` | [Friend of a Friend](http://xmlns.com/foaf/spec/) | `http://xmlns.com/foaf/0.1/` |
| `geo` | [Basic Geo Vocabulary](https://www.w3.org/2003/01/geo/) | `http://www.w3.org/2003/01/geo/wgs84_pos#` |
| `owl` | [](http://www.w3.org/2001/sw/wiki/OWL) Web Ontology Language | `http://www.w3.org/2002/07/owl#` |
| `rdf` | [](http://www.w3.org/2001/sw/wiki/RDF) RDF Syntax | `http://www.w3.org/1999/02/22-rdf-syntax-ns#` |
| `rdfs` | [](http://www.w3.org/2001/sw/wiki/RDF) RDF Schema | `http://www.w3.org/2000/01/rdf-schema#` |
| `xsd` | [XML Schema data types](https://www.w3.org/TR/xmlschema-2) | `http://www.w3.org/2001/XMLSchema#` |
| TBD | [](http://www.w3.org/2001/sw/wiki/SKOS) Simple Knowledge Organization System (SKOS) | `http://www.w3.org/2004/02/skos/core#` |
| TBD | [](http://www.w3.org/2001/sw/wiki/PROV) PROV | `http://www.w3.org/ns/prov#` |
| TBD | [](http://www.w3.org/2001/sw/wiki/RDFa) RDF in Attributes (RDFa) | `http://www.w3.org/ns/rdfa#` |
| TBD | [RDF Calendar](https://www.w3.org/TR/rdfcal/) | `http://www.w3.org/2002/12/cal#` |
| TBD | [vCard Ontology](https://www.w3.org/TR/vcard-rdf/) | `http://www.w3.org/2006/vcard/ns#` |
| TBD | [The Organization Ontology](https://www.w3.org/TR/vocab-org/) | `http://www.w3.org/ns/org#` |
| TBD | [Creative Commons Rights Expression Language](https://wiki.creativecommons.org/wiki/CC_REL) | `http://creativecommons.org/ns#` |
## The namespace Macro
The `namespace!` macro takes three parameters:
* The common prefix for the module,
* The namespace IRI for the module,
* A list of pairs where the first is the name of the function to return the IRI for the name, and the second is the
string name of the vocabulary element.
Note that as this macro uses `paste::item` the client will need to have a dependency on the [paste crate](https://crates.io/crates/paste).
## Example
The following example replicates the `geo` module using the `namespace!` macro.
```rust
#[macro_use]
extern crate rdftk_names;
use rdftk_names::Vocabulary;
namespace! {
GeoSpatialVocabulary,
"geo",
"http://www.w3.org/2003/01/geo/wgs84_pos#",
{
spatial_thing, "SpatialThing",
temporal_thing, "TemporalThing",
event, "Event",
point, "Point",
lat, "lat",
location, "location",
long, "long",
alt, "alt",
lat_long, "lat_long"
}
}
```
## Changes
**Version 0.1.8**
* rdftk_iri dependency reset to only major/minor.
**Version 0.1.8**
* Applied a lot more warnings in lib.rs
* Applied resulting warnings and Clippy suggestions.
* Reformatted macro layout.
**Version 0.1.7**
* Added missing names in rdfs vocabulary.
**Version 0.1.6**
* Updated [paste](https://crates.io/crates/paste) dependency.
**Version 0.1.5**
* Explicit version management.
**Version 0.1.3**
* `namespace!` macro now creates a local cache of `Arc<IRI>` instances to reduce memory consumption.
**Version 0.1.2**
* Added `rdf:li`.
**Version 0.1.1**
* Made `nsname!` macro public.
**Version 0.1.0**
* First release
## TODO
TBD