Skip to content

Commit

Permalink
Bug fixes in documetation
Browse files Browse the repository at this point in the history
  • Loading branch information
essepuntato committed Jun 21, 2017
1 parent 30521b0 commit 960de29
Show file tree
Hide file tree
Showing 9 changed files with 6,834 additions and 39 deletions.
12 changes: 10 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,9 @@

# RASH Framework [![Join the chat at https://gitter.im/essepuntato/rash](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/essepuntato/rash?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)

This project includes all the documents and source codes related to the **RASH Framework**, i.e., a set of specifications and writing/conversion/extraction tools for writing academic articles in [*RASH*](https://github.com/essepuntato/rash/tree/master/grammar), i.e., a markup language defined as a subset of HTML for writing scientific articles. RASH has been released with its own [documentation](https://rawgit.com/essepuntato/rash/master/documentation/index.html), which is a descriptive document that introduces the language and explains how to write research article by using it. In addition, there exist also [guidelines](https://rawgit.com/essepuntato/rash/master/documentation/rash-in-odt.odt) for OpenOffice that explain how to write a scholarly paper, by using the basic features available in OpenOffice Writer, in a way that it can be converted into RASH by means of an [appropriate conversion tool](https://github.com/essepuntato/rash/tree/master/tools/odt2rash).
This project includes all the documents and source codes related to the **RASH Framework**, i.e., a set of specifications and writing/conversion/extraction tools for writing academic articles in [*RASH*](https://github.com/essepuntato/rash/tree/master/grammar), i.e., a markup language defined as a subset of HTML for writing scientific articles. RASH has been released with its own [documentation](https://rawgit.com/essepuntato/rash/master/documentation/index.html), which is a descriptive document that introduces the language and explains how to write research article by using it. In addition, there exist also [guidelines](https://rawgit.com/essepuntato/rash/master/documentation/rash-in-odt.odt) for OpenOffice that explain how to write a scholarly paper, by using the basic features available in Apache OpenOffice Writer or Microsoft Word, in a way that it can be converted into RASH by means of appropriate conversion tools for [ODT](https://github.com/essepuntato/rash/tree/master/tools/odt2rash) and [DOCX](https://github.com/essepuntato/rash/tree/master/tools/docx2rash).

An online conversion tool called *ROCS* (*RASH Online Conversion Service*) is available at http://dasplab.cs.unibo.it/rocs. It allows one to convert an ODT document written according to the [aforementioned guidelines](https://rawgit.com/essepuntato/rash/master/documentation/rash-in-odt.odt) into RASH, which also includes the converted LaTeX document compliant with the [Springer LNCS LaTeX class](https://www.springer.com/computer/lncs?SGWID=0-164-6-793341-0) and [ACM ICPS class](https://www.acm.org/publications/proceedings-template).
An online conversion tool called *ROCS* (*RASH Online Conversion Service*) is available at http://dasplab.cs.unibo.it/rocs. It allows one to convert an ODT/DOCX document written according to the guidelines for [ODT](https://rawgit.com/essepuntato/rash/master/documentation/rash-in-odt.odt) and [DOCX](https://rawgit.com/essepuntato/rash/master/documentation/rash-in-docx.docx) files into RASH, which also includes the converted LaTeX document compliant with the [Springer LNCS LaTeX class](https://www.springer.com/computer/lncs?SGWID=0-164-6-793341-0), [ACM ICPS class](https://www.acm.org/publications/proceedings-template), the [ACM Journal Large class](http://www.acm.org/publications/authors/submissions), and the [PeerJ class](https://www.overleaf.com/latex/templates/latex-template-for-peerj-journal-and-pre-print-submissions/ptdwfrqxqzbn#.WUkVrIrOM0R).

A brief introduction of all the tools included in the Framework is provided in the [related page](https://github.com/essepuntato/rash/tree/master/tools), that includes also usage information.

Expand All @@ -13,6 +13,14 @@ Please use the hashtag *#rashfwk* for referring to any of the entities defined i
A list of papers introducing the RASH Framework is enclosed at the [end of this document](#papers-introducing-the-rash-framework), as well as a [list of all the papers](#rash-papers-accepted-in-scholarly-venues) accepted in scholarly venues that have been written in RASH.

## Venues that have adopted RASH as submission format
* [16th International Semantic Web Conference (ISWC 2017)](http://iswc2017.semanticweb.org/)

* [14th Extended Semantic Web Conference (ESWC 2017)](http://2017.eswc-conferences.org/)

* [2017 International Workshop on Semantics, Analytics, Visualisation: Enhancing Scholarly Data (SAVE-SD 2017)](http://cs.unibo.it/save-sd/2017/index.html), held during the [26th International World Wide Web Conference (WWW 2017)](http://www.www2017.com.au/)

* [3rd Workshop on Managing the Evolution and Preservation of the Data Web (MEPDaW 2017)](http://eis.iai.uni-bonn.de/Event/mepdaw2017.html), held during the [14th Extended Semantic Web Conference (ESWC 2017)](http://2017.eswc-conferences.org/)

* [7th International Workshop on Consuming Linked Data (COLD2016)](http://dcc.uchile.cl/cold2016/), held during the [15th International Semantic Web Conference (ISWC 2016)](http://iswc2016.semanticweb.org)

* [4th International Workshop on Linked Data for Information Extraction (LD4IE 2016)](http://web.informatik.uni-mannheim.de/ld4ie2016/LD4IE2016/Overview.html), held during the [15th International Semantic Web Conference (ISWC 2016)](http://iswc2016.semanticweb.org)
Expand Down
4 changes: 2 additions & 2 deletions documentation/index.html
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<!DOCTYPE html>
<!--
Research Articles in Simplified HTML (RASH) format - Documentation - Version 0.6.1, February 10, 2017
Research Articles in Simplified HTML (RASH) format - Documentation - Version 0.6.2, June 20, 2017
by Silvio Peroni
This work is licensed under a Creative Commons Attribution 4.0 International License (http://creativecommons.org/licenses/by/4.0/).
Expand Down Expand Up @@ -107,7 +107,7 @@ <h1>Introduction</h1>
<p>This paper introduces the <em>Research Articles in Simplified HTML</em> (<em><code>RASH</code></em>) format <a href="#RASH2015"></a>, i.e., a markup language that restricts the use of <a href="http://www.w3.org/TR/html5/">HTML</a> elements to only <strong>31 elements</strong> for writing academic research articles. It is possible to includes also <strong><a href="http://www.w3.org/TR/rdfa-syntax/">RDFa</a> annotations</strong> within any element of the language, and also allows one to specify other RDF annotations in <a href="http://www.w3.org/TR/turtle/">Turtle</a>, <a href="http://www.w3.org/TR/rdf-syntax-grammar/">RDF/XML</a> and <a href="http://www.w3.org/TR/json-ld/">JSON-LD</a>. In addition, RASH strictly follows the <a href="https://rawgit.com/w3c/aria/master/aria/dpub.html">Digital Publishing WAI-ARIA Module 1.0</a> (which is currently an editor draft) for expressing structural semantics on various markup elements used.</p>
<p>Concerning its theoretical foundations, RASH is entirely based on a strong theory on <em>structural patterns</em> for XML documents <a href="#Patterns2014"></a>. The systematic use of these structural patterns is an added value in all stages of the documents' lifecycle: they can be guidelines for creating well-engineered documents and vocabularies, rules to extract structural components from legacy documents, indicators to study to what extent documents share design principles and community guidelines.</p>
<p>Note that this is a meta-document, since it has been actually defined by using RASH itself as markup language. Thus you can easily access the HTML code of this page to understand how the various elements are rendered by the browser.</p>
<p>Any RASH documents begins as a simple (X)HTML5 document, by specifying the XML declaration and generic DOCTYPE followed by document element <code>html</code> with the usual namespace and with additional (and mandatory) prefix declarations (through the attribute <code>prefix</code>). The element <code>html</code> contains the element <code>head</code>, for defining metadata of the document, and the element <code>body</code>, for including the whole content of the document. The whole structure of a RASH document is then introduced as follows:</p>
<p>Any RASH documents begins as a simple HTML5 document, by specifying the generic HTML DOCTYPE followed by document element <code>html</code> with the usual namespace and with additional (and mandatory) prefix declarations (through the attribute <code>prefix</code>). The element <code>html</code> contains the element <code>head</code>, for defining metadata of the document, and the element <code>body</code>, for including the whole content of the document. The whole structure of a RASH document is then introduced as follows:</p>
<pre><code>
&lt;?xml version="1.0" encoding="UTF-8"?&gt;
&lt;!DOCTYPE html&gt;
Expand Down
Loading

0 comments on commit 960de29

Please sign in to comment.