Note: This tutorials assumes you have read the Introduction to ROS.
(!) Please ask about problems and questions regarding this tutorial on Don't forget to include in your question the link to this page, the versions of your OS & ROS, and also add appropriate tags.

Navigating the ROS wiki

Description: This tutorial discusses the layout of the ROS wiki ( and talks about how to find what you want to know.

Keywords: wiki

Tutorial Level: BEGINNER

Next Tutorial: Where Next?

This tutorial will look at the different headers, links, and sidebars through out the wiki to help you understand how is laid out.

Basics Landing Page

The landing page is where you are directed to when you type into you browser. Let's look at the ROS wiki header that is displayed at the top of every wiki page.


As you can see each package contains tutorials and troubleshooting specific to the package.

ROS Package Pages

Let's look at ros-pkg package wiki page for tf ( The package header for each package is auto generated from the stack and package manifest.


ROS Stack Pages

Let's look at ros stack wiki page for ROS ( The stack header for each stack is auto generated from the stack manifest.


As you can see each stack contains tutorials and troubleshooting specific to the stack.


Beginners can skip this section.

To create tutorial pages under your package

  1. Once you created your package page, open a URL plus /tutorials at the tail of the URL of your package. Eg. suppose your package is located at, you should open This way wiki creates a new page.

  2. You're said This page does not exist yet. What type of page are you trying to create?. Yeah wiki is right, because there's no (hopefully) such page. ROS wiki now shows a list of template so choose TutorialIndexTemplate.

  3. Now you're navigated to wiki page editor. Add whatever change you think you need, and save it at the end. Using Preview often to check how it looks is a great idea. Notice that, however, there are some ROS wiki macro that does not get activated until you save the page (in that case you just have to pray that your edition works, but it's okay to try and error!).

Sort the tutorial

By default, TutorialIndexTemplate uses a macro FullSearchWithDescriptionsCS, which searches all available tutorials under the URL hierarchy you chose ( in this case). There the order of tutorials are based on the "links" between tutorials (next.0 attribute in each page's tutorial header).

Often, you want to sort the tutorial in your own way, like ROS' basic tutorial top page does. To do so you use TutorialChain macro. See the example in ROS basic tutorials.

Wiki: th/ROS/Tutorials/NavigatingTheWiki (last edited 2014-11-19 04:54:48 by AkkharaphongEKSIRI)