Merge branch 'upstream' into debian/sid

1 files changed, 232 insertions, 0 deletions

diff --git a/data/doc/manuals_generated/sisu_manual/sisu_remote/plain.txt b/data/doc/manuals_generated/sisu_manual/sisu_remote/plain.txt
new file mode 100644
index 00000000..1c05f25f
--- /dev/null
+++ b/data/doc/manuals_generated/sisu_manual/sisu_remote/plain.txt
@@ -0,0 +1,232 @@
+SISU - REMOTE OPERATIONS [0.58],
+RALPH AMISSAH
+***********************************************
+
+SISU REMOTE OPERATIONS
+======================
+
+1. REMOTE SOURCE DOCUMENTS
+--------------------------
+
+*SiSU* 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 *SiSU* documents can either be sisu marked up
+files in plaintext .sst or .ssm or; zipped sisu files, sisupod.zip or
+filename.ssp
+
+
+*.sst / .ssm - sisu text files*
+
+
+*SiSU* 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.
+
+
+
+  sisu -3 http://[provide url to valid .sst or .ssm file]
+
+Any of the source documents in the sisu examples page can be used in this way,
+see <http://www.jus.uio.no/sisu/SiSU/2.html> and use the url for the desired
+document.
+
+
+NOTE: to set up a remote machine to serve *SiSU* documents in this way, images
+should be in the directory relative to the document source ../_sisu/image
+
+
+*sisupod - zipped sisu files*
+
+
+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.
+
+
+*SiSU* 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.
+
+
+
+  sisu -3 http://[provide url to valid sisupod.zip or .ssp file]
+
+Any of the source documents in the sisu examples page can be used in this way,
+see <http://www.jus.uio.no/sisu/SiSU/2.html> and use the url for the desired
+document.
+
+
+REMOTE DOCUMENT OUTPUT
+======================
+
+2. REMOTE OUTPUT
+----------------
+
+Once properly configured *SiSU* output can be automatically posted once
+generated to a designated remote machine using either rsync, or scp.
+
+
+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.
+
+
+
+  sisu -3R sisu_remote.sst
+
+2.1 COMMANDS
+............
+
+*-R [filename/wildcard] *
+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 "keys" and ssh agent in place. Note the behavior of rsync
+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
+
+
+*-r [filename/wildcard] *
+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 your "keys" and ssh agent in place. Also see -R
+
+
+2.2 CONFIGURATION
+.................
+
+[expand on the setting up of an ssh-agent / keychain]
+
+
+3. REMOTE SERVERS
+-----------------
+
+As *SiSU* is generally operated using the command line, and works within a Unix
+type environment, *SiSU* 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.
+
+
+DOCUMENT INFORMATION (METADATA)
+*******************************
+
+METADATA
+--------
+
+Document Manifest @
+<http://www.jus.uio.no/sisu/sisu_manual/sisu_remote/sisu_manifest.html>
+
+
+*Dublin Core* (DC)
+
+
+/DC tags included with this document are provided here./
+
+
+DC Title: _SiSU - Remote Operations [0.58]_
+
+
+DC Creator: _Ralph Amissah_
+
+
+DC Rights: _Copyright (C) Ralph Amissah 2007, part of SiSU documentation,
+License GPL 3_
+
+
+DC Type: _information_
+
+
+DC Date created: _2002-08-28_
+
+
+DC Date issued: _2002-08-28_
+
+
+DC Date available: _2002-08-28_
+
+
+DC Date modified: _2007-09-16_
+
+
+DC Date: _2007-09-16_
+
+
+*Version Information*
+
+
+Sourcefile: _sisu_remote.sst_
+
+
+Filetype: _SiSU text 0.58_
+
+
+Sourcefile Digest, MD5(sisu_remote.sst)= _5fe0c81eddcd7e3e18608b8e48b3ccad_
+
+
+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)=
+_20fc43cf3eb6590bc3399a1aef65c5a9_
+
+
+*Generated*
+
+
+Document (metaverse) last generated: _Sun Sep 23 04:11:04 +0100 2007_
+
+
+Generated by: _SiSU_ _0.59.0_ of 2007w38/0 (2007-09-23)
+
+
+Ruby version: _ ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux]_
+
+
+
+==============================================================================
+
+	title:  SiSU - Remote Operations [0.58]
+
+	creator:  Ralph Amissah
+
+	rights:  Copyright (C) Ralph Amissah 2007, part of SiSU documentation,
+               License GPL 3
+
+	type:  information
+
+	subject:  ebook, epublishing, electronic book, electronic publishing,
+               electronic document, electronic citation, data structure,
+               citation systems, search
+
+	date.created:  2002-08-28
+
+	date.issued:  2002-08-28
+
+	date.available:  2002-08-28
+
+	date.modified:  2007-09-16
+
+	date:  2007-09-16
+
+
+
+
+
+==============================================================================
+nil
+
+Other versions of this document:
+manifest:
+   http://www.jus.uio.no/sisu/sisu_remote/sisu_manifest.html
+html:
+   http://www.jus.uio.no/sisu/sisu_remote/toc.html
+pdf:
+   http://www.jus.uio.no/sisu/sisu_remote/portrait.pdf
+   http://www.jus.uio.no/sisu/sisu_remote/landscape.pdf
+plaintext (plain text):
+   http://www.jus.uio.no/sisu/sisu_remote/plain.txt
+at:
+   http://www.jus.uio.no/sisu
+* Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23)
+* Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
+* Last Generated on: Sun Sep 23 04:11:51 +0100 2007
+* SiSU http://www.jus.uio.no/sisu