| Note: Esse tutorial assume que você leu Introduction to ROS. |
 Please ask about problems and questions regarding this tutorial on answers.ros.org. Don't forget to include in your question the link to this page, the versions of your OS & ROS, and also add appropriate tags. |
Navegando na wiki do ROS
Description: Este tutorial mostra como entender a estutura do wiki do ROS (ros.org) and talks about how to find what you want to know.Keywords: wiki
Tutorial Level: BEGINNER
Next Tutorial: Where Next?
Contents
Este tutorial irá cobrir diferentes cabeçalhos (headers), links e barras laterais (sidebars) no Wiki do ROS para poder te ajudar a entender melhor como o ROS é disposto.
Básico
ROS.org Pagina Principal
A página de "pouso" (landing page) é onde você é direcionado quando digita www.ros.org no seu navegador. Vamos olhar o cabeçalho do ROS wiki que é mostrado no topo de toda pagina wiki.
Como você pode ver o pacote contém tutoriais e solução de problemas específico do pacote.
Páginas dos pacotes ROS
Vamos procurar na página do pacote ros-pkg pelo pacote tf (de transformações) tf (www.ros.org/wiki/tf). O cabeçalho (header) do pacote para cada pacote é autogerado da a partir da pilha e o manifesto do pacote.
Páginas das pilhas (Stack) do ROS
Vamos ver a página wiki em ros para ROS (www.ros.org/wiki/ROS). O cabeçalho da pilha para cada pilha é autogerado do manifesto da pilha.
Como você pode ver cada pilha possui tutoriais e solução de problemas específico/respectivo a cada pilha.
Avançado
Iniciantes podem pular esta seção.
Criando paginas de tutorial no seu pacote
1. Quando você tiver criado a pagina do seu pacote, abra a URL adicionando '/tutorials' no final da URL do seu pacote. Por exemplo, suponhamos que seu pacote está localizado em http://wiki.ros.org/foo_pkg, você dever abrir http://wiki.ros.org/foo_pkg/tutorials. Desta forma a wiki cria uma nova página.
2. Caso você receba a notificação This page does not exist yet. What type of page are you trying to create?. Sim, a wiki está correta, pois tal pagina não existe. A ROS wiki deve mostrar uma lista de template, para isso escolha TutorialIndexTemplate.
3. Agora que você navegou no editor da pagina wiki, faça qualquer mudança que você julgue necessária e salve no final. Usar a opção Preview de forma frequente para ir checando como está ficando a cara da página/documento é uma boa prática, principalmente pois este acaba salvando o que já foi feito. No entanto perceba que há algumas macros do ROS wiki que não são ativadas durante a pre-vizualização (preview), ou seja, você só conseguirá vê-la após clicar em Save Changes
Ordenar o tutorial
Por padrão, TutorialIndexTemplate usa a macro FullSearchWithDescriptionsCS, que procura todos os tutoriais disponíveis na hierarquia de URL que você escolheu (nesse caso, http://wiki.ros.org/foo_pkg/tutorials). Há outras ordens de tutoriais baseado nos elos (links) entre tutoriais, que é o atributo next.0 em cada cabeçalho da respectiva página de tutorial.
Normalmente você quer ordenar o tutorial da sua maneira, como ROS' basic tutorial top page. Para fazer isso você pode utilizar a macro TutorialChain. Veja o exemplo em ROS basic tutorials.
