From 50d45c6deb0afd2e4222d2e33a45487a9d1fa676 Mon Sep 17 00:00:00 2001 From: Ralph Amissah Date: Sun, 23 Sep 2007 05:16:21 +0100 Subject: primarily todo with sisu documentation, changelog reproduced below: * start documenting sisu using sisu * sisu markup source files in data/doc/sisu/sisu_markup_samples/sisu_manual/ /usr/share/doc/sisu/sisu_markup_samples/sisu_manual/ * default output [sisu -3] in data/doc/manuals_generated/sisu_manual/ /usr/share/doc/manuals_generated/sisu_manual/ (adds substantially to the size of sisu package!) * help related edits * manpage, work on ability to generate manpages, improved * param, exclude footnote mark count when occurs within code block * plaintext changes made * shared_txt, line wrap visited * file:// link option introduced (in addition to existing https?:// and ftp://) a bit arbitrarily, diff here, [double check changes in sysenv and hub] * minor adjustments * html url match refinement * css added tiny_center * plaintext * endnotes fix * footnote adjustment to make more easily distinguishable from substantive text * flag -a only [flags -A -e -E dropped] controlled by modifiers --unix/msdos --footnote/endnote * defaults, homepage * renamed homepage (instead of index) implications for modifying skins, which need likewise to have any homepage entry renamed * added link to sisu_manual in homepage * css the css for the default homepage is renamed homepage.css (instead of index.css) [consider removing this and relying on html.css] * ruby version < ruby1.9 * place stop on installation and working with for now [ruby String.strip broken in ruby 1.9.0 (2007-09-10 patchlevel 0) [i486-linux], 2007-09-18:38/2] * debian/control restrict use to ruby > 1.8.4 and ruby < 1.9 * debian * debian/control restrict use to ruby > 1.8.4 and ruby < 1.9 * sisu-doc new sub-package for sisu documentation debian/control and sisu-doc.install --- .../sisu_manual/sisu_remote/doc.html | 1063 ++++++++++++++++++++ 1 file changed, 1063 insertions(+) create mode 100644 data/doc/manuals_generated/sisu_manual/sisu_remote/doc.html (limited to 'data/doc/manuals_generated/sisu_manual/sisu_remote/doc.html') diff --git a/data/doc/manuals_generated/sisu_manual/sisu_remote/doc.html b/data/doc/manuals_generated/sisu_manual/sisu_remote/doc.html new file mode 100644 index 00000000..6f68d92a --- /dev/null +++ b/data/doc/manuals_generated/sisu_manual/sisu_remote/doc.html @@ -0,0 +1,1063 @@ + + + + + + SiSU + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + +
+ +
SiSU -->
+
+ + + + + + + + + + + + + + + +
+ + Full Text  scroll  + + + + + TOC linked  toc  + + + + + + PDF portrait +   pdf  + + + + + + PDF landscape +   pdf  + + + + + + ODF/ODT  odt  + + + + + +   A-Z  + + + + + + Document Manifest  + + + + + @ +
+
+   +
+

+ +

+ +
+ + +
+ +

SiSU +

+ +

Remote Operations [0.58] +

+ +

Ralph Amissah +

+ +copy @ + + SiSU + + +
+ + + +

Copyright ©  Ralph Amissah 2007, part of SiSU documentation, License GPL 3

+

+ +
+ +

+ SiSU - Remote Operations [0.58],
Ralph Amissah
+

+ +

+ SiSU Remote Operations +

+ +

+ 1. Remote Source Documents +

+ +

+ Remote Document Output +

+ +

+ 2. Remote Output +

+ +
+ 2.1 commands +
+ +
+ 2.2 configuration +
+ +

+ 3. Remote Servers +

+ +

+ Document Information (metadata) +

+ + + + +
+

+ + SiSU - Remote Operations [0.58],
Ralph Amissah +

+
+

+   1 +

+
+ + + + +
+

+ + SiSU Remote Operations +

+
+

+   2 +

+
+ + + + +
+

+ + 1. Remote Source Documents +

+
+

+   3 +

+
+ + + + +
+

+ 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 +

+
+

+   4 +

+
+ + + + +
+

+ .sst / .ssm - sisu text files +

+
+

+   5 +

+
+ + + + +
+

+ 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. +

+
+

+   6 +

+
+ + + + +
+

+ +  sisu -3 http://[provide url to valid .sst or .ssm file] + +

+
+

+   7 +

+
+ + + + +
+

+ 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. +

+
+

+   8 +

+
+ + + + +
+

+ 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 +

+
+

+   9 +

+
+ + + + +
+

+ sisupod - zipped sisu files +

+
+

+   10 +

+
+ + + + +
+

+ 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. +

+
+

+   11 +

+
+ + + + +
+

+ 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. +

+
+

+   12 +

+
+ + + + +
+

+ +  sisu -3 http://[provide url to valid sisupod.zip or .ssp file] + +

+
+

+   13 +

+
+ + + + +
+

+ 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. +

+
+

+   14 +

+
+ + + + +
+

+ + Remote Document Output +

+
+

+   15 +

+
+ + + + +
+

+ + 2. Remote Output +

+
+

+   16 +

+
+ + + + +
+

+ Once properly configured SiSU output can be automatically posted once generated to a designated remote machine using either rsync, or scp. +

+
+

+   17 +

+
+ + + + +
+

+ 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. +

+
+

+   18 +

+
+ + + + +
+

+ +  sisu -3R sisu_remote.sst + +

+
+

+   19 +

+
+ + + + +
+
+ + 2.1 commands +
+
+

+   20 +

+
+ + + + +
+

+ -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 +

+
+

+   21 +

+
+ + + + +
+

+ -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 +

+
+

+   22 +

+
+ + + + +
+
+ + 2.2 configuration +
+
+

+   23 +

+
+ + + + +
+

+ [expand on the setting up of an ssh-agent / keychain] +

+
+

+   24 +

+
+ + + + +
+

+ + 3. Remote Servers +

+
+

+   25 +

+
+ + + + +
+

+ 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. +

+
+

+   26 +

+
+ + + +
+ +

+


+

+   +
+ + + + +
+

+ + Document Information (metadata) +

+
+

+   0 +

+
+ +

+ Metadata +

+ + +     + + + + + +
+

+ <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] +

+
+ + + + + +
+ +
SiSU -->
+
+ + + + + + + + + + + + + + + +
+ + Full Text  scroll  + + + + + TOC linked  toc  + + + + + + PDF portrait +   pdf  + + + + + + PDF landscape +   pdf  + + + + + + ODF/ODT  odt  + + + + + +   A-Z  + + + + + + Document Manifest  + + + + + @ +
+
+   +
+

+ + + + + + + + +
+ +
+

+ + SiSU + +

+
+ +

+ Output generated by + + SiSU + + 0.59.0 2007-09-23 (2007w38/0) +
+ + SiSU + + Copyright © Ralph Amissah + 1997, current 2007. + All Rights Reserved. +
+ + SiSU + + is software for document structuring, publishing and search, +
+ + www.jus.uio.no/sisu + + and + + www.sisudoc.org + +
+ w3 since October 3 1993 + + ralph@amissah.com + +

+
+

+ SiSU using: +
Standard SiSU markup syntax, +
Standard SiSU meta-markup syntax, and the +
Standard SiSU object citation numbering and system, (object/text positioning system) +
+ Copyright © Ralph Amissah 1997, current 2007. + All Rights Reserved. +

+
+

+ + GPLv3 + +

+
+

+ + SiSU + + is released under + GPLv3 + or later, + <http://www.gnu.org/licenses/gpl.html> +

+
+

+ SiSU, developed using + + Ruby + + on + + Debian/Gnu/Linux + + software infrastructure, + with the usual GPL (or OSS) suspects. +
+ Better - "performance, reliability, scalability, security & total cost of ownership" + [not to mention flexibility & choice] use of and adherence to open standards (where practical and fair) and it is software libre. +
+ Get With the Future + + Way Better! + +

+
+ + + + + + + +

+ +
+
+ + +
+ + +
+ + + + idx + txt + + +
+
+ +
+

+ + +SiSU manual + +

+ + + + + + + + + + + +
+

+ + +SiSU + +

+ + + + + + + + + + + + + + + + +
+ + + + -- cgit v1.2.3