From ef766f700da90c49cbc33afd535cb70d78d4cc67 Mon Sep 17 00:00:00 2001 From: PeterThoeny Date: Sun, 7 Apr 2002 10:30:00 +0000 Subject: [PATCH] none --- TWiki/IncludeTopicsAndWebPages.mdwn | 2 +- TWiki/ManagingWebs.mdwn | 65 +++++++++++++++++++++++++++++-------- TWiki/TWikiInstallationGuide.mdwn | 3 +- TWiki/TWikiPreferences.mdwn | 2 +- TWiki/TWikiVariables.mdwn | 10 +++--- TWiki/WebHome.mdwn | 2 +- 6 files changed, 61 insertions(+), 23 deletions(-) diff --git a/TWiki/IncludeTopicsAndWebPages.mdwn b/TWiki/IncludeTopicsAndWebPages.mdwn index d84f5fe..2c09b83 100644 --- a/TWiki/IncludeTopicsAndWebPages.mdwn +++ b/TWiki/IncludeTopicsAndWebPages.mdwn @@ -21,7 +21,7 @@ Use the **%INCLUDE\{...\}%** variable to embed the content of anoth - **"page"**:
The nameless parameter specifies the page to include. It is - The name of a topic located in the current web, i.e. **%INCLUDE\{"WebNotify"\}%** - - A `Web.Topic` name specifying a topic in another web, i.e. **%INCLUDE\{"TWiki.TWikiWebsTable"\}%** + - A `Web.Topic` name specifying a topic in another web, i.e. **%INCLUDE\{"TWiki.SiteMap"\}%** - A full qualified URL with **http** protocol, domain name and optional port number, i.e. **%INCLUDE\{"http://twiki.org:80/index.html"\}%**. Supported content types are **text/html** and **text/plain**. The full page is included by default, but the HTML header and scripts are stripped in case it is a web page. - **pattern="reg-exp"**:
The **pattern** parameter is optional and allows you to extract some parts of a web page. Specify a [[RegularExpression]] that scans from start (`'^'`) to end and contains the text you want to keep in parenthesis, i.e. **pattern="^.\*?(from here.\*?to here).\*"**. You need to make sure that the integrity of a web page is not compromised, i.e. if you include a table make sure to include everything including the table end tag. diff --git a/TWiki/ManagingWebs.mdwn b/TWiki/ManagingWebs.mdwn index 3f33f79..c5d7e4d 100644 --- a/TWiki/ManagingWebs.mdwn +++ b/TWiki/ManagingWebs.mdwn @@ -11,33 +11,72 @@ # Managing Webs -_Adding, renaming and deleting webs are manual operations done directly on the server_ +_Adding webs is a web based operation; renaming and deleting webs are manual operations done directly on the server_ ## Overview -Managing TWiki webs requires direct access to the installation files on the host server. There are currently no browser-based equivalents of the Rename/move/delete topic tools for working with webs. +A [[TWikiSite]] is divided into webs; each one represents one subject, one area of collaboration. Administrators can add/rename/delete webs. -## Adding a New Web + -Adding new webs is quick and easy - you can have a basic web up and running in a couple of minutes: +## Adding a New Web -1. **Create** a new directory under `twiki/data/`, ex: `twiki/data/Newweb`
- - the name has to start with a capital and _cannot_ be a [[WikiWord]] -2. **Copy** in the contents of `twiki/data/_default`. +
Create a new web by filling out this form. Note: It is not recommended to create a new web for each little project. Cross-linking topics and search is easier if there are only a few larger webs.

+

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Name of new web: Enter a short name of up to 10 characters. The name must start with one or more upper case letters, followed by optional lower case letters or numbers; it cannot be a [[TWiki/WikiWord]]
Based on web: Select a template web (starting with an underscore) or an existing web as a template for the new web. All topics are copied over from a template web; only topics that start with Web... (like "WebHome", "WebNotify") are copied from an existing web
Web color: Enter a [[Main/StandardColors]] code for the web
Exclude web from "search all": No   Yes Specify if you want to exclude the web from a "search all webs" search
Update WIKIWEBLIST: No   Yes Specify if you want to list the new web in the WIKIWEBLIST displayed by some skins in the upper right hand corner
Description:
 
Enter a short description of the web. This is for listing the web in the [[TWiki/SiteMap]] (leave field empty if you prefer not to update the directory)
Used to...
 
Continue the sentence describing the intended use. This is also for the [[TWiki/SiteMap]]
 
For detailed instructions, see [[TWiki Installation Guide: Adding a New Web|Main/TWikiInstallationGuide#CreateWeb]]. ## Renaming or Deleting a Web +Renaming or deleting a web requires direct access to the installation files on the host server. There are currently no browser-based equivalents of the Rename/move/delete topic tools for working with webs. + **NOTE:** If you plan to rename the %WIKITOOLNAME%.Main web, remember that TWiki stores user and group topics in %MAINWEB%, default named `Main`. That means, every [[WikiName]] signature - `Main.SomeUserName` - points to it and would need updating (unless the variable, `%MAINWEB%.SomeUserName`, is used throughout). 1. Prepare your site: Search each web for links to the target web, searching topic text for `Oldwebname.`, including the dot so you'll find references like `Oldwebname.SomeTopic`. - Make changes as required, to `Newwebname.SomeTopic` or better yet, to `%MAINWEB%.SomeTopic`. 2. Edit the [[TWikiPreferences]] topic: Rename or delete the web from the `WIKIWEBLIST` variable. -3. Edit the [[TWikiWebsTable]] topic: Rename or delete the web from the table. -4. Login to the %WIKITOOLNAME% server, via Telnet or FTP. -5. Go to `twiki/data` and rename or remove the web directory. -6. Go to `twiki/templates` and rename or remove the web directory if present. -7. Go to `twiki/pub` and rename or remove the web directory if present. +3. Login to the %WIKITOOLNAME% server, via Telnet or FTP. +4. Go to `twiki/data` and rename or remove the web directory. +5. Go to `twiki/templates` and rename or remove the web directory if present. +6. Go to `twiki/pub` and rename or remove the web directory if present. --- [[MikeMannix]] - 14 Sep 2001
+-- [[MikeMannix]] - 14 Sep 2001
-- [[PeterThoeny]] - 07 Apr 2002
diff --git a/TWiki/TWikiInstallationGuide.mdwn b/TWiki/TWikiInstallationGuide.mdwn index a1f77d1..86d919d 100644 --- a/TWiki/TWikiInstallationGuide.mdwn +++ b/TWiki/TWikiInstallationGuide.mdwn @@ -206,8 +206,7 @@ To create a new web: - Customize the `%WEBTOPICLIST%` variable to contain the web-specific links you prefer. - Set the WEBBGCOLOR variable to a color. The number represents the unique color for the web. - Set Plugins, access privileges, custom variables, other web-level options (ex: `%WEBCOPYRIGHT%` can be set for an individual web). -5. **Add** the new web to the color-coded web directory table by editing the [[TWikiWebsTable]] topic. -6. **Test** the new web: view pages, create a new page. +5. **Test** the new web: view pages, create a new page. That's it for a basic new web set-up! diff --git a/TWiki/TWikiPreferences.mdwn b/TWiki/TWikiPreferences.mdwn index 2d9b223..5b8a8f0 100644 --- a/TWiki/TWikiPreferences.mdwn +++ b/TWiki/TWikiPreferences.mdwn @@ -24,7 +24,7 @@ The following are **_site-level_** settings that affect all users in all webs on ## General Preferences -- List of %WIKITOOLNAME% webs - on the first line of the upper toolbar (to add a new web, see [[ManagingWebs]] and [[TWikiWebsTable]]): +- List of %WIKITOOLNAME% webs - on the first line of the upper toolbar (to add a new web, see [[ManagingWebs]] and [[SiteMap]]): - Set WIKIWEBLIST = [[Main|Main/WebHome]] | [[TWiki|TWiki/WebHome]] | [[Know|Know/WebHome]] | [[Test|Test/WebHome]] - %T% **NOTE:** To automatically list all non-hidden webs in alphabetical order, use this variable instead:
Set WIKIWEBLIST = diff --git a/TWiki/TWikiVariables.mdwn b/TWiki/TWikiVariables.mdwn index e78046e..edf679b 100644 --- a/TWiki/TWikiVariables.mdwn +++ b/TWiki/TWikiVariables.mdwn @@ -217,7 +217,7 @@ This version of TWiki - TWiki-4.1.2, Sat, 03 Mar 2007, build 13046 - expands the %GMTIME% - GM time, is 29 Jun 2010 - 15:34 + GM time, is 29 Jun 2010 - 15:35 %GMTIME{"format"}% @@ -267,15 +267,15 @@ This version of TWiki - TWiki-4.1.2, Sat, 03 Mar 2007, build 13046 - expands the 2 digit year 99 - Variables can be shortened to 3 characters. Example:
%GMTIME{"$day $month, $year - $hour:$min:$sec"}% is
29 Jun, 2010 - 15:34:42 + Variables can be shortened to 3 characters. Example:
%GMTIME{"$day $month, $year - $hour:$min:$sec"}% is
29 Jun, 2010 - 15:35:09 %SERVERTIME% - Server time, is 29 Jun 2010 - 11:34 + Server time, is 29 Jun 2010 - 11:35 %SERVERTIME{"format"}% - Formatted server time.
Example: %SERVERTIME{"$hou:$min"}% is 11:34 + Formatted server time.
Example: %SERVERTIME{"$hou:$min"}% is 11:35 %HTTP_HOST% @@ -302,7 +302,7 @@ This version of TWiki - TWiki-4.1.2, Sat, 03 Mar 2007, build 13046 - expands the "Web.Topic" - A topic in another web, i.e. %INCLUDE{"TWiki.TWikiWebsTable"}% + A topic in another web, i.e. %INCLUDE{"TWiki.SiteMap"}% "http://..." diff --git a/TWiki/WebHome.mdwn b/TWiki/WebHome.mdwn index bd4809b..1695cd5 100644 --- a/TWiki/WebHome.mdwn +++ b/TWiki/WebHome.mdwn @@ -119,7 +119,7 @@ Documentation for webmasters, system administrators, project managers, team lead - [[WebPreferences]]: Preference settings for the this web - [[TWikiPreferences]]: %WIKITOOLNAME% site-wide preferences -- The [[TWikiWebsTable]]: A color-coded directory of available webs that can be easily included on any page _(below)_ +- The [[SiteMap]]: A color-coded directory of available webs that can be easily included on any page _(below)_ - The [[%WEB%|TWiki/WebHome]] web is coded light orange for quick identification. - TWikiTM is a trademark of [[PeterThoeny]] -- 1.9.4