The authoritative file for this node is kept in the CVS project sysadmin-tools, subproject manage-wiki-node. It's generally a good idea to update this node by updating the file in CVS instead. To do that you checkout the project, and then do manage-wiki-node -e ManageWikiNode > README, edit README, and then do manage-wiki-node -u ManageWikiNode -f README -s "Type Summary here". Of cousre you can also edit this webpage too, but the README in CVS is always more authoritative. 8JE

manage-wiki-node 8ID

SYNOPSIS 8IE

Usage: manage-wiki-node [OPTIONAL_OPTION] REQUIRED_OPTION WikiNodeName? 8IF

DESCRIPTION 8IG

Manage PurpleWiki nodes for a Wiki running on localhost. You can create, retrieve, edit, update, and test nodes for existence. 8IH

REQUIRED OPTIONS 8II

Exactly one option from below is required. 8IJ

-c 8IK: Create node. Creates a new node named WikiNodeName?. If WikiNodeName? exists than an error message is returned. 8IL

-u 8IM: Update node. If WikiNodeName? doesn't exist an error is printed. The input file, whether it be STDIN or not, is expected to have the node's old time stamp on the first line. If this time stamp is different than the one currently associated with the node then the update fails. 8IO

-U 8IP: Like -u above but if WikiNodeName? doesn't exist the node is created as with -c instead of causing an error. 8IQ

-e 8IR: Edit node. If WikiNodeName? doesn't exist an error is printed. The content of WikiNodeName? is printed to STDOUT in the following form: The first line of output contains the node's timestamp which is in seconds since the epoch. The remaining lines contain the WikiText? as it is stored in the WikiDB?. The timestamp should be saved and will be used by -u later. 8IS

-g format 8IT: Get node. If WikiNodeName? does not exist an error is printed. Format is case insensitive and is one of the following: 8IU

WikiText? - Returns raw WikiText? as it is stored in the DB. 8IV
XHTML - Returns the HTML as it would be returned to a browser. 8IW
WikiHTML? - Returns only the HTML associated with the WikiNode? content. The default HTML header and footers are not supplied. 8IX
Text - Returns the plain text version of the node. 8IY

Notice that -g WikiText? is the same as -e with the time stamp removed. The time stamp represents when you started editing and so -e should not be used with -g WikiText? if you're writing scripts to manage nodes. The -g option is intended for informational uses only. 8IZ

-E 8J0: Test node existence. Node's existence status is printed out. If WikiNodeName? does not exist then an error code of 1 is set. 8J1

OPTIONAL OPTIONS 8J2

These may be supplied with the above options. 8J3

-s text 8J4: Summary. The argument text given is used as the summary information for the RecentChanges page. Otherwise a default message about the node being generated from manage-wiki-node is used. 8J5

-f filename 8J6: Input redirection. If input is needed it's taken from filename. Errors are not redirected. 8J7

-q 8J8: Quiet mode. Don't print error message or any extraneous output. Output from -g or -e will still be written out. 8J9

-h 8JA: Help. Display help information and causes all other options to be ignored. 8JB