1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
|
<!-- manual page source format generated by PolyglotMan v3.2, -->
<!-- available at http://polyglotman.sourceforge.net/ -->
<html>
<head>
<title>"sisu_remote"("1") manual page</title>
</head>
<body bgcolor='white'>
<a href='#toc'>Table of Contents</a><p>
SISU - REMOTE OPERATIONS [0.58], RALPH AMISSAH
<p> SISU REMOTE OPERATIONS
<p> 1. REMOTE SOURCE DOCUMENTS
<p> <b>SiSU</b> processing instructions can be run against
remote source documents by providing the url of the documents against which
the processing instructions are to be carried out. The remote <b>SiSU</b> documents
can either be sisu marked up files in plaintext .sst or .ssm or; zipped sisu
files, sisupod.zip or filename.ssp
<p> <b>.sst / .ssm - sisu text files</b>
<p> <b>SiSU</b> can
be run against source text files on a remote machine, provide the processing
instruction and the url. The source file and any associated parts (such
as images) will be downloaded and generated locally.
<p>
<p> <br>
<pre> sisu -3 http://[provide url to valid .sst or .ssm file]
</pre>
<p> Any of the source documents in the sisu examples page can be used in
this way, see <<a href='http://www.jus.uio.no/sisu/SiSU/2.html'>http://www.jus.uio.no/sisu/SiSU/2.html</a>
> and use the url for the
desired document.
<p> NOTE: to set up a remote machine to serve <b>SiSU</b> documents
in this way, images should be in the directory relative to the document
<p>source ../_sisu/image
<p> <b>sisupod - zipped sisu files</b>
<p> A sisupod is the zipped
content of a sisu marked up text or texts and any other associated parts
to the document such as images.
<p> <b>SiSU</b> can be run against a sisupod on a
(local or) remote machine, provide the processing instruction and the url,
the sisupod will be downloaded and the documents it contains generated
locally.
<p>
<p> <br>
<pre> sisu -3 http://[provide url to valid sisupod.zip or .ssp file]
</pre>
<p> Any of the source documents in the sisu examples page can be used in
this way, see <<a href='http://www.jus.uio.no/sisu/SiSU/2.html'>http://www.jus.uio.no/sisu/SiSU/2.html</a>
> and use the url for the
desired document.
<p> REMOTE DOCUMENT OUTPUT
<p> 2. REMOTE OUTPUT
<p> Once properly
configured <b>SiSU</b> output can be automatically posted once generated to a
designated remote machine using either rsync, or scp.
<p> In order to do this
some ssh authentication agent and keychain or similar tool will need to
be configured. Once that is done the placement on a remote host can be done
seamlessly with the -r (for scp) or -R (for rsync) flag, which may be used
in conjunction with other processing flags, e.g.
<p>
<p> <br>
<pre> sisu -3R sisu_remote.sst
</pre>
<p> 2.1 COMMANDS
<p>
<dl>
<dt><b> -R [filename/wildcard]</b> </dt>
<dd>copies sisu output files to remote
host using rsync. This requires that sisurc.yml has been provided with information
on hostname and username, and that you have your different if -R is used
with other flags from if used alone. Alone the rsync --delete parameter is
sent, useful for cleaning the remote directory (when -R is used together
with other flags, it is not). Also see -r
<p> </dd>
<dt><b> -r [filename/wildcard]</b> </dt>
<dd>copies sisu
output files to remote host using scp. This requires that sisurc.yml has
been provided with information on hostname and username, and that you have
<p>your
<p> </dd>
</dl>
2.2 CONFIGURATION
<p> [expand on the setting up of an ssh-agent / keychain]
<p> 3. REMOTE SERVERS
<p> As <b>SiSU</b> is generally operated using the command line,
and works within a Unix type environment, <b>SiSU</b> the program and all documents
can just as easily be on a remote server, to which you are logged on using
a terminal, and commands and operations would be pretty much the same as
they would be on your local machine.
<p> DOCUMENT INFORMATION (METADATA)
<p>
METADATA
<p> Document Manifest @ <<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_remote/sisu_manifest.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_remote/sisu_manifest.html</a>
>
<p> <b>Dublin Core</b> (DC)
<p> <i>DC</i> tags included with this document are provided here.
<p> DC Title: <i>SiSU</i> - Remote Operations [0.58]
<p> DC Creator: <i>Ralph</i> Amissah
<p>
DC Rights: <i>Copyright</i> (C) Ralph Amissah 2007, part of SiSU documentation,
<p>License GPL 3
<p> DC Type: <i>information</i>
<p> DC Date created: <i>2002-08-28</i>
<p> DC Date
issued: <i>2002-08-28</i>
<p> DC Date available: <i>2002-08-28</i>
<p> DC Date modified: <i>2007-09-16</i>
<p> DC Date: <i>2007-09-16</i>
<p> <b>Version Information</b>
<p> Sourcefile: <i>sisu_remote.sst</i>
<p> Filetype: <i>SiSU</i> text 0.58
<p> Sourcefile Digest, MD5(sisu_remote.sst)= <i>5fe0c81eddcd7e3e18608b8e48b3ccad</i>
<p> Skin_Digest: MD5(/home/ralph/grotto/theatre/dbld/sisu-dev/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)=
<p><i>20fc43cf3eb6590bc3399a1aef65c5a9</i>
<p> <b>Generated</b>
<p> Document (metaverse) last
generated: <i>Sun</i> Sep 23 01:14:02 +0100 2007
<p> Generated by: <i>SiSU</i> <i>0.58.3</i> of
2007w36/4 (2007-09-06)
<p> Ruby version: <i>ruby</i> 1.8.6 (2007-06-07 patchlevel 36)
[i486-linux]
<p>
<p>
<dl>
<dt>Other versions of this document: </dt>
<dd></dd>
<dt>manifest: <<a href='http://www.jus.uio.no/sisu/sisu_remote/sisu_manifest.html'><a href='http://www.jus.uio.no/sisu/sisu_remote/sisu_manifest.html'>http://www.jus.uio.no/sisu/sisu_remote/sisu_manifest.html</a>
</a>
>
</dt>
<dd></dd>
<dt>html: <<a href='http://www.jus.uio.no/sisu/sisu_remote/toc.html'><a href='http://www.jus.uio.no/sisu/sisu_remote/toc.html'>http://www.jus.uio.no/sisu/sisu_remote/toc.html</a>
</a>
> </dt>
<dd></dd>
<dt>pdf: <<a href='http://www.jus.uio.no/sisu/sisu_remote/portrait.pdf'><a href='http://www.jus.uio.no/sisu/sisu_remote/portrait.pdf'>http://www.jus.uio.no/sisu/sisu_remote/portrait.pdf</a>
</a>
>
</dt>
<dd></dd>
<dt>pdf: <<a href='http://www.jus.uio.no/sisu/sisu_remote/landscape.pdf'><a href='http://www.jus.uio.no/sisu/sisu_remote/landscape.pdf'>http://www.jus.uio.no/sisu/sisu_remote/landscape.pdf</a>
</a>
> </dt>
<dd> </dd>
<dt>at: <<a href='http://www.jus.uio.no/sisu'><a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a>
</a>
>
</dt>
<dd></dd>
<dt>* Generated by: SiSU 0.58.3 of 2007w36/4 (2007-09-06) </dt>
<dd></dd>
<dt>* Ruby version: ruby
1.8.6 (2007-06-07 patchlevel 36) [i486-linux] </dt>
<dd></dd>
<dt>* Last Generated on: Sun Sep 23
01:14:07 +0100 2007 </dt>
<dd></dd>
<dt>* SiSU <a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a>
</dt>
<dd></dd>
</dl>
<p>
</body>
</html>
|
