diff options
Diffstat (limited to 'data/doc/manuals_generated/sisu_manual/sisu_remote/plain.txt')
| -rw-r--r-- | data/doc/manuals_generated/sisu_manual/sisu_remote/plain.txt | 232 |
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 |