New Wiki
Open, ConfirmedPublic


NOTE: The new Wiki is not in use yet, we're still planning the steps to get there.

Recently Dan set up a fresh install of Media Wiki and migrated the old pages to it. This can be found at

Note that there is a simple password so normal users won't confuse it with the real wiki.
Username: wiki
Password: wiki

There are still several todos


Clean Structure



I don't know that I would go so far as to remove the old 2.4/2.5 manuals that exist in the wiki as they are the only manual that exists for them, unless people feel we could just assume it to be deprecated and removed from existence.

I wonder if it would be better to maybe try doing a one time conversion of the old 2.4 wiki manual back over to sphinx, once we do versioning over there with the manual. At least then we could provide redirects to the manual that would be indexed by Google and searchable/findable by people with old versions of Blender, or people who are merely curious.

As for how to structure and layout the updated wiki, I don't really have any opinion here as I am not the person that edits stuff. If you like using transclusion to create pages, that's up to the editors.

On the topic of a theme, Naiad is currently broken for the navigation tree on the left of the page. Personally I say scrap it; it looked nice but was too coupled (IMHO) to the extensions and templates/transcluded pages etc. I also believe it has problems with mobile? Anyway, I think it to be a terrible design when half the site breaks just be changing to a stock skin, like vector.

I also am curious what others think about the idea of moving to a Wiki family and using interwiki links for languages (eg:,,, etc.) for translation of everything else on the wiki, very much like how wikipedia does things.

Aaron Carlisle (Blendify) raised the priority of this task from Normal to Confirmed.

Ok, I think I have a clearer idea about the whole old wiki version things. We should keep the old manuals but not have wiki version for the rest of the wiki. Here is my idea on how this should be structured.

  • Home Page
    • Manual
      • Current (redirect)
      • 2.5
      • 2.4
    • Other wiki pages

I don't have a strong opinion on whether the old manuals get moved to sphinx.

Hello everyone !

Manual theme redesign
Current vogue is in the material and flat designs.
I think the wiki could benefit of efficient space usage just as shown in this image.

A little bit of CSS magic can help change the current wiki remake to be on the same level as:

Manual versions
As far as the old wiki goes; I think we should keep the latest major versions just for retrospective [2.40, 2.50, 2.60, 2.xx ].
There should also be a latest version, updated on the fly.

Thanks a bunch Dan for setting up new wiki! :)


2.4 and 2.5 manuals: those would simply remain readonly, kind of 'archived'. I don’t see much point on wasting time on them to port to sphinx or whatever, but there is no reason to remove them either, they can be 'forgotten' in their own corner imho. :P

In fact, maybe we could have an 'archived' section in the wiki, where we explicitly dump any page which is no more in sync with current blender - would include said manuals, but also all old design and tech docs that are no more really relevant. This way, no need for 'version' name spaces.


Agree it would be nice to make it coherent with other blender sites, but imho most important thing is to have something easy to maintain and update along with wikimedia. So rather use a well known and maintained skin (even default one?), with a few as possible customization (css-only ;) ).

Naiad was a great result, but trying to make wiki not look like a wiki requires tremendous work - to create it and to keep it working at each update! Let's not forget that wiki, now that manual uses its own stuff, will mostly be tech doc place. We want to keep it simple and easy to use and maintain, more than everything else.

The problems with Naiad is (currently) the Nav tree is missing. The problem with Any of the stock skins is that we have a bunch of Naiad related cruft in the templates that make a stock nav area break, so things need clean up if we want to go that route. It doesn't matter to me either way; I am just letting you know that if we go with a stock setup, there is a lot of work needed to clean things up and bring it back to a stock setup.

+1 for @Bastien Montagne (mont29)'s reply.
Best we have wiki that can be maintained and not focus too much on customization unless if gives real practical benefits and doesn't prevent us from upgrading in the future.


I have no idea how much work is to setup the new skin, vs stripping down our current version to be compatible with the default skin.
That being said, I am all in favor for css tweaks so that it looks like the other blender websites, as long as it is not too much work.
I am not so worried about styling, but about the functionality of the navigation.

+1 for read-only versioning. I understand that this means to keep the content as it currently is, with new material going to sphinx.

I think the default skin is better than going back to the old Naiad.

I started to do some cleanup of the current wiki today, mostly in the release notes area, but ran into a problem when trying to delete pages.
Currently, there is no way to batch delete files. I did a simple Google search and found some solutions that might help:

However, there may be a chance that these will not work due to the old media wiki version that we use.
In this case, I think that we should layout a day where shut down the wiki and move to the new wiki.
From here we can use those scripts to delete many pages that we don't need. A big example
here would be the old manual translations (2.4, and 2.5, 2.6).

So this is mainly a question for @Dan McGrath (dmcgrath) on whether the scripts would work or not,
If not we need to get a time frame for when to shut down the wiki and make the new wiki default.

Hi @Aaron Carlisle (Blendify),

There is a problem with the current wiki in that we cannot add new extensions. Normally when you add an extension you need to run an upgrade script to extend the database schema, but this script is broken in the current database due to a problem with Latin/UTF problems, so we wouldn't be able to activate new extensions. The problem gets fixed when we upgrade Mediawiki though, so the new system would be able to run these extensions just fine, and I believe are even included in the new site.

It may be possible that I can I run some of the admin scripts in the shell to delete specific urls though. Looking at the shell, I do see a "deleteBatch.php" script. It appears to take a text file with a list of pages to delete:

  • <listfile> : File with titles to delete, separated by newlines

Maybe this would be enough? Or would you guys rather wait and switch to the new wiki instead?

It seems like you are talking about which was the second bullet point.

No, there are php scripts in the maintenance folder in Mediawiki installs that let you do stuff that may or may not be available through the web UI. The extensions I think are more meant for people without shell access.


From here we can use those scripts to delete many pages that we don't need. A big example here would be the old manual translations (2.4, and 2.5, 2.6).

Where was this ever agreed on? Translations should be handled the same as english manual imho, archived and made non-editable, but why deleted?

After trying to work on T48381 I found that the current wiki is too slow for me to do anything.
I think the best solution right now is to do a little theme clean up and make the merge to
After everyone is forced to use pages can be added/removed/moved has needed with a lot more ease.

I have just checked the manual, and there have been performance improvements, so it should be back to normal now.

Today i found in the official wiki that vimeo videos seem to be embedded by using the flash video player. I propose to customize or update the <vimeo> plugin so that it uses the html5 player instead. Here is an example page:

When i open this page with firefox, then i get the warning about usage of flash.

I also noticed that it looks like the new wiki does not (yet?) support the <vimeo> tag. I believe it is important to at least support embedding of videos from vimeo and youtube.

Aaron Carlisle (Blendify) changed Type from Bug to Design.Feb 8 2017, 6:30 PM


Is it planned to allow to log in to the (upcoming) new wiki with a account?
I hope it will be considered because it's not currently possible to log into with a account...


could be archived and a new set of pages created for addons.
as one of the original authors and designers of this page and
I would be happy to work with wiki devs to see the new pages created for blender 2.8 series.