77bf236f0dc3e6f6cbd6132114d8830947022c4c
[src/app-framework-main.git] / doc / widgets.html
1 <html>
2 <head>
3   <link rel="stylesheet" type="text/css" href="doc.css">
4   <meta charset="UTF-8">
5 </head>
6 <body>
7 <a name="The.widgets"></a>
8 <h1>The widgets</h1>
9
10 <pre><code>version: 1
11 Date:    15 March 2016
12 Author:  José Bollo
13 </code></pre>
14
15 <a name="The.widgets"></a>
16 <h2>The widgets</h2>
17
18 <p>The widgets are described by the technical recommendations
19 <a href="http://www.w3.org/TR/widgets" title="Packaged Web Apps">widgets</a> and <a href="http://www.w3.org/TR/widgets-digsig" title="XML Digital Signatures for Widgets">widgets-digsig</a>.</p>
20
21 <a name="signature.of.the"></a>
22 <h3>signature of the</h3>
23
24 <p>The application framework</p>
25
26 <p>This is the original part of our work here</p>
27
28 <a name="directory.where.are.stored.applications"></a>
29 <h3>directory where are stored applications</h3>
30
31 <p>Applications can be installed in few places: on the system itself or on an extension device.
32 For my phone, for example, it is the sd card.</p>
33
34 <p>This translates to:</p>
35
36 <ul>
37 <li>/usr/applications: for system wide applications</li>
38 <li>/opt/applications: for removable applications</li>
39 </ul>
40
41
42 <p>In the remaining of the document, these places are writen &ldquo;APPDIR&rdquo;.</p>
43
44 <a name="Organisation.of.directory.of.applications"></a>
45 <h1>Organisation of directory of applications</h1>
46
47 <p>The main path for applivcations are: APPDIR/PKGID/VER.</p>
48
49 <p>Where:</p>
50
51 <ul>
52 <li>APPDIR is as defined above</li>
53 <li>PKGID is a directory whose name is the package identifier</li>
54 <li>VER is the version of the package MAJOR.MINOR</li>
55 </ul>
56
57
58 <p>This organisation has the advantage to allow several versions to leave together.
59 This is needed for some good reasons (rolling back) and also for less good reasons (user habits).</p>
60
61 <a name="Identity.of.installed.files"></a>
62 <h2>Identity of installed files</h2>
63
64 <p>All the files are installed as the user &ldquo;userapp&rdquo; and group &ldquo;userapp&rdquo;.
65 All files have rw(x) for user and r-(x) for group and others.</p>
66
67 <p>This allows any user to read the files.</p>
68
69 <a name="Labelling.the.directories.of.applications"></a>
70 <h2>Labelling the directories of applications</h2>
71
72 <a name="Organisation.of.data"></a>
73 <h1>Organisation of data</h1>
74
75 <p>The data of a user are in its directory and are labelled using the labels of the application</p>
76 </body>
77 </html>