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, 0 insertions, 232 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 deleted file mode 100644 index f1e02e5a..00000000 --- a/data/doc/manuals_generated/sisu_manual/sisu_remote/plain.txt +++ /dev/null @@ -1,232 +0,0 @@ -SISU - REMOTE OPERATIONS, -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_ - - -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)= _9bdac464998dc3f034fbd8f80df23b83_ - - -Skin_Digest: -MD5(/home/ralph/grotto/theatre/dbld/builds/sisu/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)= -_20fc43cf3eb6590bc3399a1aef65c5a9_ - - -*Generated* - - -Document (metaverse) last generated: _Tue Sep 25 02:54:15 +0100 2007_ - - -Generated by: _SiSU_ _0.59.1_ of 2007w39/2 (2007-09-25) - - -Ruby version: _ ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux]_ - - - -============================================================================== - - title: SiSU - Remote Operations - - 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.1 of 2007w39/2 (2007-09-25) -* Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux] -* Last Generated on: Tue Sep 25 02:54:16 +0100 2007 -* SiSU http://www.jus.uio.no/sisu |