Priority: Normal
Current State: No Action Required
Released In: n/a
Target Release: n/a
/bin/configure
is very good at providing "I expected..." hints for various path variables. However, it doesn't provide one for
{ScriptUrlPaths}{view}
I ran into a problem today when setting up a Foswiki to run at
.../foswiki/...
. The site came up, but all of the links were wrong.
I finally figured out what was wrong somewhat by accident.
The information under
{ScriptUrlPaths}{view}
says:
This is the complete path used to access the Foswiki view script including any suffix.
Do not include a trailing /. (This is an exception override, so the ScriptSuffix is not automatically added.) e.g. /foswiki/bin/view.pl
Note: The default is acceptable except when shorter URLs are used.
If you are using Shorter URL's, then this is typically set to the base path of your wiki, which should
be the value of {ScriptUrlPath} excluding /bin. e.g. if your {ScriptUrlPath} is either
empty or set to /bin leave {ScriptUrlPaths}{view} empty; if it is set to something like
/directory/bin set it to /directory
1. Although
{ScriptUrlPaths}{view}
is marked
required the note says "DO not change this unless..." (which implies
not required) and the "default" appears to be blank (i.e. not required).
2. The part that could throw an "I expected" warning or error: if
{ScriptUrlPath}
is set to something like /directory/bin set
{ScriptUrlPaths}{view}
to /directory.
My
{ScriptUrlPath}
was set to
/foswiki/bin
.
My
{ScriptUrlPaths}{view}
was set to ''.
It should have been easy, programmatically, to test this and print a hint, "I expected this to be /foswiki".
Then I would have discovered my issue an hour earlier and saved a lot of head-on-desk.
--
VickiBrown - 26 Jan 2015
This is actually fixed on Foswiki 1.2. The new configure has a lot of significant improvements. For example, clicking the "verify" button traces access to to the server to detect redirects, etc:
Tracing access to http://foswiki.com/bin/view, {ScriptUrlPaths}{view} = '' Server received the expected path: (empty)
And one that's in error:
Server received (), but the configured path to view is (/bin). Changing {ScriptUrlPaths}{view} to () will probably correct this error. (Server may be configured for Shorter URLs.)
And in addition, we are doing a lot of work on a new Foswiki "bootstrap". Install without any configuration. then visit your expected view URL. Foswiki should be functional, but you'll get a warning banner that says to click a link to visit configure to complete the configuration. By using Foswiki before configuration, it is able to guess the correct settings for the settings you mention above.
Setting to "No Action"
--
GeorgeClark - 26 Jan 2015