SID-02407: How do I change the name of a Web?

Status:	Answered	TWiki version:	6.0.1	Perl version:	5.22
Category:	CategoryInstallation	Server OS:	Ubuntu 16.04	Last update:	6 years ago

I want to change the name of a Web, currently 'Project1'. This page indicates that I can "Rename a web via the Tools section in each web's WebPreferences topic."

If I go to https://mywiki.org/Project1/WebPreferences, there is no Tools section, nor any entry I can see that's relevant to changing the name of a Web.

On other pages, for example https://mywiki.org/Main/WebPreferences or https://mywiki.org/TWiki/WebPreferences, the page ends with the two sections "Related Topics" and then "Rename, Move or Delete this Web". The WebPreferences of Project1, however, doesn't contain this last section; it ends with "Related Topics".

Permissions

I'm logged in as the admin user, so it shouldn't be a permissions problem. The above link mentions specific permissions settings; for my case, these are

1) "You must be allowed to rename and changes topics in the web you want to rename "

That's Project1/WebPreferences

=ALLOWWEBCHANGE = TWikiAdminGroup =

=ALLOWWEBRENAME = TWikiAdminGroup =

2) "You must be allowed to rename topics in the parent web of the web you want to rename"

Project1 doesn't have an explicit parent, but just in case the TWiki Web counts as a "root" parent for all other webs, that would be

TWiki/WebPreferences

=ALLOWTOPICRENAME = TWikiAdminGroup =

3) "If the web is a root web (i.e. it has no parent web) then you must have permission to both create and rename root webs. These permissions are controlled by the ALLOWROOTCHANGE preference, which can be set in TWikiPreferences."

That's Main/TWikiPreferences

=ALLOWROOTCHANGE = TWikiAdminUser =

I think these settings satisfy the requirements.

I am willing to edit config files directly, if it helps. How do I change the name of the Project1 Web?

-- TWiki Guest - 2019-05-21

Discussion and Answer

This is a bit strange, because actually all webs should pull the sections "Help on Preferences", "Related Topics", and (sic!) "Rename, Move or Delete this Web" from the same source. If you don't see this section, then someone changed a page (not necessarily this page), because after all, it is a Wiki. Originally, these sections are iincluded from your WebPreferencesHelp topic, which in turn imports it from RenameWeb (here, of course, the links go to the corresponding topics on twiki.org). The RenameWeb page, if viewed directly, just tells you that the TWiki web can not be renamed (well, it can, but not via the web interface).

To fix this, the Perl curse applies: TIMTOWTDI (There is more than one way to do it.)

• The TWiki way (1): You can edit your WebPreferences topic and add %INCLUDE{"%SYSTEMWEB%.WebPreferencesHelp"}% to re-establish the magic. Or, if you have this line, examine TWiki/WebPreferencesHelp whether the last line there reads %INCLUDE{"%SYSTEMWEB%.RenameWeb"}%.
• The TWiki way (2): Alternatively, you could directly visit https://mywiki.org/bin/rename/Project1/WebPreferences?action=renameweb which might be easier.
• The sysadmin way: Rename the directories data/Project1 and pub/Project1. This is quick, dirty, and goes most of the way.

The difference between the TWiki way and the sysadmin way is that only the TWiki way will also offer to change all pages where you have references to topics in the Project1 web. Such references occur either if you explicitly link to a topic in the web, or if you rename a topic in that web because this renaming is kept in the topic's history.

-- Harald Jörg - 2019-05-21

The TWiki way (1) worked and restored the "Rename, Move or Delete this Web" section, along with a link to the URL you mention in the TWiki way (2). That link worked! I am glad to know about the sysadmin way, though, so I'm glad you included that.

I think the installation is all set now. Thanks again for taking the time to help me out!

-- TWiki Guest - 2019-05-22

I'm glad to hear that it works!

What I like most is that information stored in a TWiki is a long-time fun. I have topics which are 15 years old, still relevant, and have survived a couple of hardware, operating system, and web server changes without any problems

-- Harald Jörg - 2019-05-23

If you answer a question - or someone answered one of your questions - please remember to edit the page and set the status to answered. The status selector is below the edit box.