Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Support
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
J
jio
Project overview
Project overview
Details
Activity
Releases
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Issues
0
Issues
0
List
Boards
Labels
Milestones
Merge Requests
0
Merge Requests
0
CI / CD
CI / CD
Pipelines
Jobs
Schedules
Analytics
Analytics
CI / CD
Repository
Value Stream
Wiki
Wiki
Snippets
Snippets
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Create a new issue
Jobs
Commits
Issue Boards
Open sidebar
Aurel
jio
Commits
2f5f21ae
Commit
2f5f21ae
authored
Dec 18, 2013
by
Marco Mariani
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
fixed sphinx build for readthedocs.org
parent
4b50d859
Changes
8
Hide whitespace changes
Inline
Side-by-side
Showing
8 changed files
with
71 additions
and
110 deletions
+71
-110
Makefile
Makefile
+0
-29
docs/_static/jio-2.0.0-wip-min.zip
docs/_static/jio-2.0.0-wip-min.zip
+0
-0
docs/_static/jio-2.0.0-wip.zip
docs/_static/jio-2.0.0-wip.zip
+0
-0
docs/available_storages.rst
docs/available_storages.rst
+3
-6
docs/conf.py
docs/conf.py
+3
-3
docs/getting_started.rst
docs/getting_started.rst
+17
-18
docs/metadata.rst
docs/metadata.rst
+48
-51
docs/style_guide.rst
docs/style_guide.rst
+0
-3
No files found.
Makefile
View file @
2f5f21ae
...
...
@@ -83,35 +83,6 @@ zip:
# mkdir "$tmpdir"/storage && \
#
# cp -r jio.storage/localstorage.js "$tmpdir"/storage && \
# cp -r jio.storage/davstorage.js "$tmpdir"/storage && \
# cp -r jio.storage/erp5storage.js "$tmpdir"/storage && \
# cp -r jio.storage/indexstorage.js "$tmpdir"/storage && \
# cp -r jio.storage/gidstorage.js "$tmpdir"/storage && \
# cp -r jio.storage/replicatestorage.js "$tmpdir"/storage && \
# cp -r jio.storage/splitstorage.js "$tmpdir"/storage && \
#
# ##############################
#
# cd "$tmpdir" && \
# res=$?
#
# #cd - >/dev/null && \
# rm -rf "$tmpdir"
# exit $res
#
.phony
:
clean
clean
:
find
-name
'*~'
-delete
...
...
docs/_static/jio-2.0.0-wip-min.zip
0 → 100644
View file @
2f5f21ae
File added
docs/_static/jio-2.0.0-wip.zip
0 → 100644
View file @
2f5f21ae
File added
docs/available_storages.rst
View file @
2f5f21ae
.. role:: js(code)
:language: javascript
.. _list-of-available-storages:
List of Available Storages
...
...
@@ -28,9 +25,9 @@ LocalStorage
Three methods are provided:
*
:js:`.createDescription(username, [application_name], [mode='localStorage'])
`
*
:js:`.createLocalDescription(username, [application_name])
`
*
:js:`.createMemoryDescription(username, [application_name])
`
*
``.createDescription(username, [application_name], [mode='localStorage'])`
`
*
``.createLocalDescription(username, [application_name])`
`
*
``.createMemoryDescription(username, [application_name])`
`
All parameters are strings.
...
...
docs/conf.py
View file @
2f5f21ae
...
...
@@ -27,7 +27,7 @@ import sys, os
# Add any Sphinx extension module names here, as strings. They can be extensions
# coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
extensions
=
[
'sphinx.ext.todo'
,
'sphinx.ext.ifconfig'
,
'sphinxcontrib.jsdemo'
]
extensions
=
[
'sphinx.ext.todo'
,
'sphinx.ext.ifconfig'
]
#
, 'sphinxcontrib.jsdemo']
# Add any paths that contain templates here, relative to this directory.
templates_path
=
[
'_templates'
]
...
...
@@ -50,9 +50,9 @@ copyright = u'2013, Nexedi'
# built documents.
#
# The short X.Y version.
version
=
'2.0.0'
version
=
'2.0.0
-wip
'
# The full version, including alpha/beta/rc tags.
release
=
'2.0.0'
release
=
'2.0.0
-wip
'
# The language for content autogenerated by Sphinx. Refer to documentation
# for a list of supported languages.
...
...
docs/getting_started.rst
View file @
2f5f21ae
.. role:: js(code)
:language: javascript
Getting started
===============
...
...
@@ -57,30 +54,30 @@ Getting started
#. The jIO API provides ten main methods to manage documents across the storage(s) specified in your jIO storage tree.
======================= ======================================================
==
======================= ======================================================
Method Example
======================= ======================================================
==
``.post()`` |
:js:`my_jio.post(document, [options]);
`
======================= ======================================================
``.post()`` |
``my_jio.post(document, [options]);`
`
| Creates a new document
``.put()`` |
:js:`my_jio.put(document, [options]);
`
``.put()`` |
``my_jio.put(document, [options]);`
`
| Creates/Updates a document
``.putAttachment()`` |
:js:`my_jio.putAttachement(attachment, [options]);
`
``.putAttachment()`` |
``my_jio.putAttachement(attachment, [options]);``
`
| Updates/Adds an attachment to a document
``.get()`` |
:js:`my_jio.get(document, [options]);
`
``.get()`` |
``my_jio.get(document, [options]);`
`
| Reads a document
``.getAttachment()`` |
:js:`my_jio.getAttachment(attachment, [options]);
`
``.getAttachment()`` |
``my_jio.getAttachment(attachment, [options]);`
`
| Reads a document attachment
``.remove()`` |
:js:`my_jio.remove(document, [options]);
`
``.remove()`` |
``my_jio.remove(document, [options]);`
`
| Deletes a document and its attachments
``.removeAttachment()`` |
:js:`my_jio.removeAttachment(attachment, [options]);
`
``.removeAttachment()`` |
``my_jio.removeAttachment(attachment, [options]);`
`
| Deletes a document's attachment
``.allDocs()`` |
:js:`my_jio.allDocs([options]);
`
``.allDocs()`` |
``my_jio.allDocs([options]);`
`
| Retrieves a list of existing documents
``.check()`` |
:js:`my_jio.check(document, [options]);
`
``.check()`` |
``my_jio.check(document, [options]);`
`
| Checks the document state
``.repair()`` |
:js:`my_jio.repair(document, [options]);
`
``.repair()`` |
``my_jio.repair(document, [options]);`
`
| Repairs the document
======================= ======================================================
==
======================= ======================================================
...
...
@@ -89,10 +86,12 @@ Getting started
Download & Fork
---------------
Please note that the current (2.0.0-wip) version is not stable yet.
You can use one of the ZIP packages, which include all the dependencies and storages:
`Full download (172k) <_static/jio-2.0.0.zip>`_
`Minified download (87k) <_static/jio-2.0.0-min.zip>`_
`Full download (172k) <_static/jio-2.0.0
-wip
.zip>`_
`Minified download (87k) <_static/jio-2.0.0-
wip-
min.zip>`_
or you can create your own set of files, which are are provided in the above packages and the source repository:
...
...
docs/metadata.rst
View file @
2f5f21ae
.. role:: js(code)
:language: javascript
.. _metadata-head:
Metadata
...
...
@@ -61,15 +58,15 @@ Identification
^^^^^^^^^^^^^^
* **_id**
A specific jIO metadata which helps the storage to find a document
(can be a real path name, a dc:identifier, a uuid, ...). **String Only**
* **identifer**
|
:js:`{"identifier": "http://domain/jio_home_page"}
`
|
:js:`{"identifier": "urn:ISBN:978-1-2345-6789-X"}
`
|
:js:`{"identifier": [{"scheme": "DCTERMS.URI", "content": "http://domain/jio_home_page"}]}
`
|
``{"identifier": "http://domain/jio_home_page"}`
`
|
``{"identifier": "urn:ISBN:978-1-2345-6789-X"}`
`
|
``{"identifier": [{"scheme": "DCTERMS.URI", "content": "http://domain/jio_home_page"}]}`
`
An unambiguous reference to the resource within a given context. Recommended
best practice is to identify the resource with a string or number
...
...
@@ -80,9 +77,9 @@ Identification
and the `International Standard Book Number <http://en.wikipedia.org/wiki/Isbn>`_ (ISBN).
* **format**
|
:js:`{"format": ["text/html", "52 kB"]}
`
|
:js:`{"format": ["image/jpeg", "100 x 100 pixels", "13.2 KiB"]}
`
|
``{"format": ["text/html", "52 kB"]}`
`
|
``{"format": ["image/jpeg", "100 x 100 pixels", "13.2 KiB"]}`
`
The physical or digital manifestation of the resource. Typically, Format may
include the media-type or dimensions of the resource. Examples of dimensions
...
...
@@ -90,9 +87,9 @@ Identification
hardware or other equipment needed to display or operate the resource.
* **date**
|
:js:`{"date": "2011-12-13T14:15:16Z"}
`
|
:js:`{"date": {"scheme": "DCTERMS.W3CDTF", "content": "2011-12-13"}}
`
|
``{"date": "2011-12-13T14:15:16Z"}`
`
|
``{"date": {"scheme": "DCTERMS.W3CDTF", "content": "2011-12-13"}}`
`
A date associated with an event in the life cycle of the resource. Typically,
Date will be associated with the creation or availability of the resource.
...
...
@@ -101,10 +98,10 @@ Identification
and follows the YYYY-MM-DD format.
* **type**
|
:js:`{"type": "Text"}
`
|
:js:`{"type": "Image"}
`
|
:js:`{"type": "Dataset"}
`
|
``{"type": "Text"}`
`
|
``{"type": "Image"}`
`
|
``{"type": "Dataset"}`
`
The nature or genre of the content of the resource. Type includes terms describing
general categories, functions, genres, or aggregation levels for content.
...
...
@@ -116,25 +113,25 @@ Intellectual property
^^^^^^^^^^^^^^^^^^^^^
* **creator**
|
:js:`{"creator": "Tristan Cavelier"}
`
|
:js:`{"creator": ["Tristan Cavelier", "Sven Franck"]}
`
|
``{"creator": "Tristan Cavelier"}`
`
|
``{"creator": ["Tristan Cavelier", "Sven Franck"]}`
`
An entity primarily responsible for creating the content of the resource.
Examples of a Creator include a person, an organization, or a service.
Typically the name of the Creator should be used to indicate the entity.
* **publisher**
|
:js:`{"publisher": "Nexedi"}
`
|
``{"publisher": "Nexedi"}`
`
The entity responsible for making the resource available. Examples of a
Publisher include a person, an organization, or a service. Typically, the name
of a Publisher should be used to indicate the entity.
* **contributor**
|
:js:`{"contributor": ["Full Name", "Full Name", ...]}
`
|
``{"contributor": ["Full Name", "Full Name", ...]}`
`
An entity responsible for making contributions to the content of the
resource. Examples of a Contributor include a person, an organization or a
...
...
@@ -142,9 +139,9 @@ Intellectual property
entity.
* **rights**
|
:js:`{"rights": "Access limited to members"}
`
|
:js:`{"rights": "https://www.j-io.org/documentation/jio-documentation/#copyright-and-license"}
`
|
``{"rights": "Access limited to members"}`
`
|
``{"rights": "https://www.j-io.org/documentation/jio-documentation/#copyright-and-license"}`
`
Information about rights held in and over the resource. Typically a Rights
element will contain a rights management statement for the resource, or
...
...
@@ -158,15 +155,15 @@ Content
^^^^^^^
* **title**
|
:js:`{"title": "jIO Home Page"}
`
|
``{"title": "jIO Home Page"}`
`
The name given to the resource. Typically, a Title will be a name by which the resource is formally known.
* **subject**
|
:js:`{"subject": "jIO"}
`
|
:js:`{"subject": ["jIO", "basics"]}
`
|
``{"subject": "jIO"}`
`
|
``{"subject": ["jIO", "basics"]}`
`
The topic of the content of the resource. Typically, a Subject will be
expressed as keywords or key phrases or classification codes that describe the
...
...
@@ -174,17 +171,17 @@ Content
controlled vocabulary or formal classification scheme.
* **description**
|
:js:`{"description": "Simple guide to show the basics of jIO"}
`
|
:js:`{"description": {"lang": "fr", "content": "Ma description"}}
`
|
``{"description": "Simple guide to show the basics of jIO"}`
`
|
``{"description": {"lang": "fr", "content": "Ma description"}}`
`
An account of the content of the resource. Description may include but is not
limited to: an abstract, table of contents, reference to a graphical
representation of content or a free-text account of the content.
* **language**
|
:js:`{"language": "en"}
`
|
``{"language": "en"}`
`
The language of the intellectual content of the resource. Recommended best
practice for the values of the Language element is defined by `RFC 3066 <http://www.ietf.org/rfc/rfc3066.txt>`_
...
...
@@ -194,8 +191,8 @@ Content
United Kingdom.
* **source**
|
:js:`{"source": ["Image taken from a drawing by Mr. Artist", "<phone number>"]}
`
|
``{"source": ["Image taken from a drawing by Mr. Artist", "<phone number>"]}`
`
A Reference to a resource from which the present resource is derived. The
present resource may be derived from the Source resource in whole or part.
...
...
@@ -203,16 +200,16 @@ Content
number conforming to a formal identification system.
* **relation**
|
:js:`{"relation": "Resilience project"}
`
|
``{"relation": "Resilience project"}`
`
A reference to a related resource. Recommended best practice is to reference
the resource by means of a string or number conforming to a formal
identification system.
* **coverage**
|
:js:`{"coverage": "France"}
`
|
``{"coverage": "France"}`
`
The extent or scope of the content of the resource. Coverage will typically
include spatial location (a place name or geographic co-ordinates), temporal
...
...
@@ -224,22 +221,22 @@ Content
as sets of co-ordinates or date ranges.
* **category**
|
:js:`{"category": ["parent/26323", "resilience/javascript", "javascript/library/io"]}
`
|
``{"category": ["parent/26323", "resilience/javascript", "javascript/library/io"]}`
`
The category the resource is associated with. The categories may look like
navigational facets, they correspond to the properties of the resource which
can be generated with metadata or some other information (see `faceted search <https://en.wikipedia.org/wiki/Faceted_search>`_).
* **product**
|
:js:`{"product": "..."}
`
|
``{"product": "..."}`
`
For e-commerce use.
* **custom**
|
:js:`{custom1: value1, custom2: value2, ...}
`
|
``{custom1: value1, custom2: value2, ...}`
`
...
...
@@ -353,7 +350,7 @@ Posting a book
},
"format" : "application/pdf",
"date" : {
"scheme": "DCTERMS.W3CDTF",
"scheme": "DCTERMS.W3CDTF",
"content": getW3CDate()
}, // see tools below
"creator" : "Original Author(s)",
...
...
docs/style_guide.rst
View file @
2f5f21ae
.. role:: js(code)
:language: javascript
.. _style-guide:
JavaScript Style Guide
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment