ROS Resources: Documentation | Support | Discussion Forum | Index | Service Status | ros @ Robotics Stack Exchange
Ask Your Question

How to open custom wiki page subdomain (e.g. and its experience

asked 2014-09-27 18:16:40 -0500

130s gravatar image

updated 2014-09-27 18:18:48 -0500

First, please don't get me wrong, I don't mean I want to open a custom domain.

MoveIt! project uses for their wiki contents (that are stored on github according to @Dave Coleman) instead of .

Question-1. How is it possible to open a custom sub domain (again I have no interest in doing that. This question has just lingered in mind for a long time)?

Question-2. It looks like running the own server to generate the own html format from .rst files. Maybe I like to ask the maintainers @Sachin Chitta @hersh @acorn about its experience, especially the downside, since ROS wiki as I'll mention below has a lot of advantages.

Background of this question: While I like ROS wiki with lots of useful macros that are specific to ROS world. I'm also a fan of aethetics aspect of ROS wiki. And using ROS wiki for all documentation gives a sense that all information regarding ROS is centralized under , which is a huge plus for both beginners and advanced users IMO. On the other hand, we have a kind of strong motivation to keep all resources including document files in our repositories for the maintainability and portability (I assume that's the same with the decision MoveIt! team?). Currently I can't think of any easy way to synchronize raw text documents on ROS wiki to the external sites.

edit retag flag offensive close merge delete

1 Answer

Sort by ยป oldest newest most voted

answered 2014-09-29 11:02:14 -0500

hersh gravatar image

I totally agree with the urge to keep document files in the same repository as the code.

The only downside I have seen to running your own documentation website is that you have to run a website. That said, if all you're doing is hosting a bunch of auto-generated pages, there will be a bunch of up-front work to set it up and then sporadic bursts of work when things break, or it gets hacked or whatever.

I'm pretty sure that doing a subdomain is just a matter of 1) running a webserver on a computer with a static IP address and 2) getting the (super-)domain owner to add your webserver's address into their server configuration as a subdomain.

edit flag offensive delete link more



Couldn't we come up with a way to integrate those auto-generated pages into the ROS wiki? That way storing documentation sources in versioning systems becomes possible for everyone.

gvdhoorn gravatar image gvdhoorn  ( 2014-09-29 14:45:25 -0500 )edit

It already IS integrated, to some extent. Look at for instance. Sure it's a separate page, but the ROS wiki has a link to it (here: )

hersh gravatar image hersh  ( 2014-09-29 15:37:40 -0500 )edit

I know the 'doc' links, but I was thinking more along the lines of actually integrating the output of the generation process into the wiki pages themselves (instead of linking to them). It's probably not a good idea to generate moinmoin code directly, but embedding something would be nice.

gvdhoorn gravatar image gvdhoorn  ( 2014-09-30 03:49:35 -0500 )edit

I'm sure it's possible to auto-generate wiki content and post it with a script. You could even read and archive it with a script. However anyone wanting to do such a thing should really talk to the OSRF folks first - last I knew was really overloaded.

hersh gravatar image hersh  ( 2014-09-30 10:30:03 -0500 )edit

Indeed it seems like ROS packages could benefit from using the auto-generated API docs more often, and better integrating them into kind of like how ompl does:

Dave Coleman gravatar image Dave Coleman  ( 2014-09-30 11:53:36 -0500 )edit

Yeah, we have considered some sort of embedding of generated documentation into the wiki pages using a wiki macro. There are some difficulties related to this approach in terms of the output from generated docs. I think something like GitHub's rendered README.{md,rst,etc...} files would be nice.

William gravatar image William  ( 2014-09-30 12:25:27 -0500 )edit

Another approach is what's referred to as an "un-wiki", which is like the ros2 design website: Where every page is generated from documents in a git repo and each page has an edit button which takes you to something like and changes go through pull requests.

William gravatar image William  ( 2014-09-30 12:26:49 -0500 )edit

This "un-wiki" is basically provided by , which I have taken to using for hosting of docs lately: (every page there has an edit on github button) Other options we have looked into: gitbook ( )

William gravatar image William  ( 2014-09-30 12:29:04 -0500 )edit

Question Tools



Asked: 2014-09-27 18:16:40 -0500

Seen: 492 times

Last updated: Sep 29 '14