Skip to content
This repository
Browse code

updated description of main and sub-projects, some clean-up

  • Loading branch information...
commit 040912eb19e449d7aa5385a4c84ad7a2daae63a2 1 parent 72ee121
Michael Hausenblas authored June 17, 2011
63  README.md
Source Rendered
... ...
@@ -1,40 +1,55 @@
1  
-# Schema.org in RDF
  1
+# Schema.RDFS.org
2 2
 
3  
-This is a project to provide an RDF(S) version of Schema.org including tools to benefit from data that uses Schema.org terms.
  3
+This is a project to provide an RDF(S) version of Schema.org terms, including tools, examples and mappings to benefit from data that uses Schema.org terms. Currently, we have the following sub-projects (in descending order of maturity):
4 4
 
  5
+* Generating variants
  6
+* Schema.org gateway
  7
+* Examples
  8
+* Mappings
5 9
 
6  
-## Who is behind this?
7  
-
8  
-The EC FP7  LOD-Around-The-Clock Support Action (<a href="http://latc-project.eu/">LATC</a>) and people from the Linked Data Research Centre, [DERI](http://www.deri.ie).
  10
+## Sub-projects
9 11
 
10  
-## License
  12
+Over time, a number of sub-projects of Schema.RDFS.org emerged, introduced in the following. Have a look at the respective directories for more details.
11 13
 
12  
-This software is Public Domain.
  14
+### Generating variants
  15
+[This](https://github.com/mhausenblas/schema-org-rdf/tree/master/scrapers) Schema.RDFS.org sub-project deals with generating structured representations for Schema.org terms through the natural language definition found in Schema.org.
13 16
 
  17
+### Schema.org gateway
14 18
 
15  
-## Generating the RDF and other versions
  19
+[This](https://github.com/mhausenblas/schema-org-rdf/tree/master/tools/schema-gateway) Schema.RDFS.org sub-projec develops the Schema.org gateway, a anything-to-anything data format converter, based on the [Lingua Franca](http://c2.com/cgi/wiki?LinguaFrancaPattern "Lingua Franca Pattern") pattern.
16 20
 
17  
-Run the following Python scripts in the `scrapers` directory:
  21
+### Examples
18 22
 
19  
-    scrape_rdf.py
20  
-    scrape_json.py
21  
-    scrape_csv.py
  23
+[This](https://github.com/mhausenblas/schema-org-rdf/tree/master/examples) Schema.RDFS.org sub-project collects Schema.org examples in all kinds of markup and data formats, incl. RDFa, CSV, JSON etc.
22 24
 
23  
-They either write to STDOUT or to a filename taken as command line argument.
  25
+### Mappings
24 26
 
25  
-There is also a script that generates all formats, does a bit of sanity checking to see if it worked, and copies them to a target directory. 
  27
+[This](https://github.com/mhausenblas/schema-org-rdf/tree/master/mappings) Schema.RDFS.org sub-project collects mappings to Schema.org terms from widely deployed Linked Data vocabularies such as Dublin Core, FOAF, GoodRelations, SIOC, DBpedia ontology, etc.
26 28
 
27  
-    cd scrapers
28  
-    ./run.rb temp-directory target-directory
  29
+## Who is behind this?
29 30
 
30  
-This requires the [any23](http://developers.any23.org/) command line tool on the path.
  31
+Led by [Michael](http://sw-app.org/mic.xhtml#i) and [Richard](http://richard.cyganiak.de/foaf.rdf#cygri) of the Linked Data Research Centre, [DERI](http://www.deri.ie) the Schema.RDFS.org project is officially endorsed and supported by the EC FP7 LOD-Around-The-Clock Support Action (<a href="http://latc-project.eu/">LATC</a>). Many people from the Linked Data domain, Web of Data domain and other communities (SEO, library, archives, etc.) are contributing and have been delivering valuable input.
31 32
 
  33
+If you have any questions, please do not hesitate to ask Michael, either via [michael.hausenblas AT gmail.com](mailto:&#x6D;&#x69;&#x63;&#x68;&#x61;&#x65;&#x6C;&#x2E;&#x68;&#x61;&#x75;&#x73;&#x65;&#x6E;&#x62;&#x6C;&#x61;&#x73;&#x40;&#x67;&#x6D;&#x61;&#x69;&#x6C;&#x2E;&#x63;&#x6F;&#x6D;) or via Twitter where he listens to [@mhausenblas](http://twitter.com/mhausenblas/) or drop by at the [#swig](http://chatlogs.planetrdf.com/swig/) channel on Freenode/IRC.
32 34
 
33  
-## Roadmap/Ideas
  35
+## License
34 36
 
35  
-* multi-lang labels/comments
36  
-* mappings to well-known legacy terms
37  
-* get the community involved and give them a sense of ownership
38  
-** feedback on a Wiki?
39  
-** mappings/multi-lang suggestions into a Google spreadsheet?
40  
-* Produce RDFa markup examples, similar to the microdata ones on schema.org
  37
+The software and artefacts (such as examples, mappings, etc.) provided through the Schema.RDFS.org project are, if not otherwise stated, in the Public Domain.
  38
+
  39
+## Roadmap and Ideas
  40
+
  41
+* Community
  42
+	* get communities involved and give them a sense of ownership (ML, Twitter, here, etc.)
  43
+	* feedback on a Wiki, issue tracker, etc. (?)
  44
+* Generating variants
  45
+	* multi-lang labels/comments
  46
+	* mappings to well-known legacy terms
  47
+* Schema.org gateway
  48
+	* http://bibutils.refbase.org/ extensions and collaboration
  49
+* Examples
  50
+	* collect
  51
+	* create based on existing examples
  52
+* Mappings
  53
+	** multi-lang suggestions into a Google spreadsheet?
  54
+	* Alexandre will provide SIOC mapping, hosted directly here
  55
+	* ask vocab stake-holders to provide pointers to their mapping (Michael: DBpedia, FOAF, DC, GR, Richard: the rest ;)
6  examples/README.md
Source Rendered
... ...
@@ -1,10 +1,10 @@
1 1
 # What is this space for?
2 2
 This space is for collecting Schema.org examples. You're encouraged to provide all kinds of markup and data formats, incl. RDFa, CSV, JSON etc.
3 3
 
4  
-# Are there IPR and license issues?
  4
+## Are there IPR and license issues?
5 5
 We understand that whoever contributes here, in the `examples/*` folder, agrees to put the provided example into the Public Domain.
6 6
 
7  
-# Where should I put my stuff?
  7
+## Where should I put my stuff?
8 8
 Into the respective `{dataformat}` folder, such as:
9 9
 
10 10
 	Thing
@@ -12,7 +12,7 @@ Into the respective `{dataformat}` folder, such as:
12 12
 		|_ CSV
13 13
 		|_ JSON
14 14
 
15  
-# Whom can I ask if I dunno what or how to do it
  15
+## Whom can I ask if I dunno what or how to do it
16 16
 Ask Michael. Either via [michael.hausenblas AT gmail.com](mailto:&#x6D;&#x69;&#x63;&#x68;&#x61;&#x65;&#x6C;&#x2E;&#x68;&#x61;&#x75;&#x73;&#x65;&#x6E;&#x62;&#x6C;&#x61;&#x73;&#x40;&#x67;&#x6D;&#x61;&#x69;&#x6C;&#x2E;&#x63;&#x6F;&#x6D;) or via Twitter where he listens to [@mhausenblas](http://twitter.com/mhausenblas/) or drop by at the [#swig](http://chatlogs.planetrdf.com/swig/) channel on Freenode/IRC.
17 17
 
18 18
 
8  mappings/README.md
Source Rendered
... ...
@@ -1,10 +1,10 @@
1 1
 # What is this space for?
2  
-This space is for collecting mappings to Schema.org terms from widely deployed Linked Data vocabularies, such as [in preparation](http://mappings.dbpedia.org/) by DBpedia, to be expected for top-level vocabularies such as [Dublin Core](http://dublincore.org/) or [FOAF](http://www.foaf-project.org/) or via 3rd party providers such as [schemapedia.com](http://schemapedia.com/).
  2
+This space is for collecting mappings to Schema.org terms from widely deployed Linked Data vocabularies, such as [in preparation](http://mappings.dbpedia.org/) by DBpedia, to be expected for top-level vocabularies such as [Dublin Core](http://dublincore.org/), [FOAF](http://www.foaf-project.org/), [GoodRelations](http://purl.org/goodrelations/), and [SIOC](http://sioc-project.org/) or that come from 3rd party providers such as [schemapedia.com](http://schemapedia.com/).
3 3
 
4  
-# Are there IPR and license issues?
5  
-We understand that whoever contributes here, in the `mappings/*` folder, agrees to put the provided example into the Public Domain.
  4
+## Are there IPR and license issues?
  5
+We understand that whoever contributes here, in the `mappings/*` folder, agrees to put the provided example into the Public Domain. If you simply provide a link to your mapping, of course, your respective IPR apply.
6 6
 
7  
-# Whom can I ask if I dunno what or how to do it
  7
+## Whom can I ask if I dunno what or how to do it
8 8
 Ask Michael. Either via [michael.hausenblas AT gmail.com](mailto:&#x6D;&#x69;&#x63;&#x68;&#x61;&#x65;&#x6C;&#x2E;&#x68;&#x61;&#x75;&#x73;&#x65;&#x6E;&#x62;&#x6C;&#x61;&#x73;&#x40;&#x67;&#x6D;&#x61;&#x69;&#x6C;&#x2E;&#x63;&#x6F;&#x6D;) or via Twitter where he listens to [@mhausenblas](http://twitter.com/mhausenblas/) or drop by at the [#swig](http://chatlogs.planetrdf.com/swig/) channel on Freenode/IRC.
9 9
 
10 10
 
28  scrapers/README.md
Source Rendered
... ...
@@ -0,0 +1,28 @@
  1
+# What is this space for?
  2
+This space is contains the scripts for generating structured representations of Schema.org terms.
  3
+
  4
+In order to generate variants (that is RDF, JSON or CSV versions) of the Schema.org terms, run the following Python scripts in the `scrapers` directory:
  5
+
  6
+    scrape_rdf.py
  7
+    scrape_json.py
  8
+    scrape_csv.py
  9
+
  10
+They either write to STDOUT or to a filename taken as command line argument.
  11
+
  12
+There is also a script that generates all formats, does a bit of sanity checking to see if it worked, and copies them to a target directory. 
  13
+
  14
+    cd scrapers
  15
+    ./run.rb temp-directory target-directory
  16
+
  17
+This requires the [any23](http://developers.any23.org/) command line tool on the path.
  18
+
  19
+
  20
+
  21
+## License
  22
+
  23
+This software is Public Domain.
  24
+
  25
+## Whom can I ask if I dunno what or how to do it
  26
+Ask Richard via Twitter [@cygri](http://twitter.com/cygri).
  27
+
  28
+
11  tools/schema-gateway/README.md
Source Rendered
... ...
@@ -0,0 +1,11 @@
  1
+# What is this space for?
  2
+This space is developing the Schema.org gateway, a anything-to-anything data format converter, based on the [Lingua Franca](http://c2.com/cgi/wiki?LinguaFrancaPattern "Lingua Franca Pattern") pattern. Conceptually, the gateway takes whatever kind of data format that uses [Schema.org](http://schema.org) terms, turns it internally into RDF and then outputs any other kind of target data format.
  3
+
  4
+## License
  5
+
  6
+This software is Public Domain.
  7
+
  8
+## Whom can I ask if I dunno what or how to do it
  9
+Ask Michael. Either via [michael.hausenblas AT gmail.com](mailto:&#x6D;&#x69;&#x63;&#x68;&#x61;&#x65;&#x6C;&#x2E;&#x68;&#x61;&#x75;&#x73;&#x65;&#x6E;&#x62;&#x6C;&#x61;&#x73;&#x40;&#x67;&#x6D;&#x61;&#x69;&#x6C;&#x2E;&#x63;&#x6F;&#x6D;) or via Twitter where he listens to [@mhausenblas](http://twitter.com/mhausenblas/) or drop by at the [#swig](http://chatlogs.planetrdf.com/swig/) channel on Freenode/IRC.
  10
+
  11
+

0 notes on commit 040912e

Please sign in to comment.
Something went wrong with that request. Please try again.