feed.xml

<?xml version="1.0" encoding="utf-8"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="en">
<title type="text">O'Botics</title>
<generator uri="https://github.com/mojombo/jekyll">Jekyll</generator>
<link rel="self" type="application/atom+xml" href="http://o-botics.org/feed.xml" />
<link rel="alternate" type="text/html" href="http://o-botics.org" />
<updated>2014-07-29T10:18:04-04:00</updated>
<id>http://o-botics.org/</id>
<author>
  <name>O-Botics</name>
  <uri>http://o-botics.org/</uri>
  <email>rowoflo@o-botics.org</email>
</author>


<entry>
  <title type="html"><![CDATA[New Robot and Roboticist]]></title>
  <link rel="alternate" type="text/html" href="http://o-botics.org/news/new-robot-and-roboticist/"/>
  <id>http://o-botics.org/news/new-robot-and-roboticist</id>
  <updated>2014-06-14T00:00:00-00:00</updated>
  <published>2014-06-14T00:00:00-04:00</published>
  
  <author>
    <name>O-Botics</name>
    <uri>http://o-botics.org</uri>
    <email>rowoflo@o-botics.org</email>
  </author>
  <content type="html">&lt;p&gt;&lt;a href=&quot;http://www.delijati.net/&quot;&gt;Josip Delic&lt;/a&gt; is the first person (besides myself) to add a new robot to the &lt;a href=&quot;../../robots/&quot;&gt;robot page&lt;/a&gt; and to add himself to the &lt;a href=&quot;../../roboticists/&quot;&gt;roboticist page&lt;/a&gt;.
The robot is the &lt;a href=&quot;../../robots/ultrabot/&quot;&gt;UltraBot&lt;/a&gt;. It looks like a cheaper alternative to the QuickBot.&lt;/p&gt;

&lt;p&gt;Awesome job Josip! I am looking forward to seeing what else you add in the future.&lt;/p&gt;

&lt;!-- Do not edit below this line --&gt;

&lt;div id=&quot;disqus_thread&quot;&gt;&lt;/div&gt;
&lt;script type=&quot;text/javascript&quot;&gt;
    /* * * CONFIGURATION VARIABLES: EDIT BEFORE PASTING INTO YOUR WEBPAGE * * */
    
      var disqus_shortname = &#39;o-botics&#39;; // required: replace example with your forum shortname
    

    /* * * DON&#39;T EDIT BELOW THIS LINE * * */
    (function() {
        var dsq = document.createElement(&#39;script&#39;); dsq.type = &#39;text/javascript&#39;; dsq.async = true;
        dsq.src = &#39;//&#39; + disqus_shortname + &#39;.disqus.com/embed.js&#39;;
        (document.getElementsByTagName(&#39;head&#39;)[0] || document.getElementsByTagName(&#39;body&#39;)[0]).appendChild(dsq);
    })();
&lt;/script&gt;

&lt;noscript&gt;Please enable JavaScript to view the &lt;a href=&quot;http://disqus.com/?ref_noscript&quot;&gt;comments powered by Disqus.&lt;/a&gt;&lt;/noscript&gt;
&lt;p&gt;&lt;a href=&quot;http://disqus.com&quot; class=&quot;dsq-brlink&quot;&gt;comments powered by &lt;span class=&quot;logo-disqus&quot;&gt;Disqus&lt;/span&gt;&lt;/a&gt;&lt;/p&gt;

  &lt;p&gt;&lt;a href=&quot;http://o-botics.org/news/new-robot-and-roboticist/&quot;&gt;New Robot and Roboticist&lt;/a&gt; was originally published by O-Botics at &lt;a href=&quot;http://o-botics.org&quot;&gt;O'Botics&lt;/a&gt; on June 14, 2014.&lt;/p&gt;</content>
</entry>


<entry>
  <title type="html"><![CDATA[QuickBot field test]]></title>
  <link rel="alternate" type="text/html" href="http://o-botics.org/news/quickbot-field-test/"/>
  <id>http://o-botics.org/news/quickbot-field-test</id>
  <updated>2014-05-05T00:00:00-00:00</updated>
  <published>2014-05-05T00:00:00-04:00</published>
  
  <author>
    <name>O-Botics</name>
    <uri>http://o-botics.org</uri>
    <email>rowoflo@o-botics.org</email>
  </author>
  <content type="html">&lt;p&gt;Video of my QuickBot field test&lt;/p&gt;

&lt;iframe width=&quot;560&quot; height=&quot;315&quot; src=&quot;//www.youtube.com/embed/5rOYVlgJui8?rel=0&quot; frameborder=&quot;0&quot; allowfullscreen=&quot;&quot;&gt;&lt;/iframe&gt;

&lt;p&gt;This is a QuickBot MOOC v1 robot, but powered by a LiPo battery (instead of two 4xAA packs).&lt;/p&gt;

&lt;p&gt;Software that drives robot can be found in &lt;a href=&quot;http://github.com/pgmmpk/quickbot_api&quot;&gt;my github repository&lt;/a&gt;
(it is pure Python, no MatLab).&lt;/p&gt;

&lt;p&gt;Robot switches between following strategies:&lt;/p&gt;

&lt;ol&gt;
  &lt;li&gt;“Go Straight” - drives robot forward until it “sees” an obstacle. Then supervisor passes control to&lt;/li&gt;
  &lt;li&gt;“Avoid Collision” - reverses if necessary to establish some clearance. When done, yields to&lt;/li&gt;
  &lt;li&gt;“Find New Direction” - rotates until it sees a “clear” direction, then yields to “Go Straight”&lt;/li&gt;
&lt;/ol&gt;

&lt;!-- Do not edit below this line --&gt;

&lt;div id=&quot;disqus_thread&quot;&gt;&lt;/div&gt;
&lt;script type=&quot;text/javascript&quot;&gt;
    /* * * CONFIGURATION VARIABLES: EDIT BEFORE PASTING INTO YOUR WEBPAGE * * */
    
      var disqus_shortname = &#39;o-botics&#39;; // required: replace example with your forum shortname
    

    /* * * DON&#39;T EDIT BELOW THIS LINE * * */
    (function() {
        var dsq = document.createElement(&#39;script&#39;); dsq.type = &#39;text/javascript&#39;; dsq.async = true;
        dsq.src = &#39;//&#39; + disqus_shortname + &#39;.disqus.com/embed.js&#39;;
        (document.getElementsByTagName(&#39;head&#39;)[0] || document.getElementsByTagName(&#39;body&#39;)[0]).appendChild(dsq);
    })();
&lt;/script&gt;

&lt;noscript&gt;Please enable JavaScript to view the &lt;a href=&quot;http://disqus.com/?ref_noscript&quot;&gt;comments powered by Disqus.&lt;/a&gt;&lt;/noscript&gt;
&lt;p&gt;&lt;a href=&quot;http://disqus.com&quot; class=&quot;dsq-brlink&quot;&gt;comments powered by &lt;span class=&quot;logo-disqus&quot;&gt;Disqus&lt;/span&gt;&lt;/a&gt;&lt;/p&gt;

  &lt;p&gt;&lt;a href=&quot;http://o-botics.org/news/quickbot-field-test/&quot;&gt;QuickBot field test&lt;/a&gt; was originally published by O-Botics at &lt;a href=&quot;http://o-botics.org&quot;&gt;O'Botics&lt;/a&gt; on May 05, 2014.&lt;/p&gt;</content>
</entry>


<entry>
  <title type="html"><![CDATA[Added QuickBot MOOC v2 Robot]]></title>
  <link rel="alternate" type="text/html" href="http://o-botics.org/news/added-quickbot-mooc-v2-robot/"/>
  <id>http://o-botics.org/news/added-quickbot-mooc-v2-robot</id>
  <updated>2014-04-25T00:00:00-00:00</updated>
  <published>2014-04-25T00:00:00-04:00</published>
  
  <author>
    <name>O-Botics</name>
    <uri>http://o-botics.org</uri>
    <email>rowoflo@o-botics.org</email>
  </author>
  <content type="html">&lt;p&gt;I have updated the QuickBot to version 2.&lt;/p&gt;

&lt;p&gt;Check it out here &lt;a href=&quot;/robots/quickbot/mooc/v2/index.html&quot;&gt;QuickBot MOOC v2&lt;/a&gt;&lt;/p&gt;

&lt;!-- Do not edit below this line --&gt;

&lt;div id=&quot;disqus_thread&quot;&gt;&lt;/div&gt;
&lt;script type=&quot;text/javascript&quot;&gt;
    /* * * CONFIGURATION VARIABLES: EDIT BEFORE PASTING INTO YOUR WEBPAGE * * */
    
      var disqus_shortname = &#39;o-botics&#39;; // required: replace example with your forum shortname
    

    /* * * DON&#39;T EDIT BELOW THIS LINE * * */
    (function() {
        var dsq = document.createElement(&#39;script&#39;); dsq.type = &#39;text/javascript&#39;; dsq.async = true;
        dsq.src = &#39;//&#39; + disqus_shortname + &#39;.disqus.com/embed.js&#39;;
        (document.getElementsByTagName(&#39;head&#39;)[0] || document.getElementsByTagName(&#39;body&#39;)[0]).appendChild(dsq);
    })();
&lt;/script&gt;

&lt;noscript&gt;Please enable JavaScript to view the &lt;a href=&quot;http://disqus.com/?ref_noscript&quot;&gt;comments powered by Disqus.&lt;/a&gt;&lt;/noscript&gt;
&lt;p&gt;&lt;a href=&quot;http://disqus.com&quot; class=&quot;dsq-brlink&quot;&gt;comments powered by &lt;span class=&quot;logo-disqus&quot;&gt;Disqus&lt;/span&gt;&lt;/a&gt;&lt;/p&gt;

  &lt;p&gt;&lt;a href=&quot;http://o-botics.org/news/added-quickbot-mooc-v2-robot/&quot;&gt;Added QuickBot MOOC v2 Robot&lt;/a&gt; was originally published by O-Botics at &lt;a href=&quot;http://o-botics.org&quot;&gt;O'Botics&lt;/a&gt; on April 25, 2014.&lt;/p&gt;</content>
</entry>


<entry>
  <title type="html"><![CDATA[Tutorial -- Adding Content to O'Botics]]></title>
  <link rel="alternate" type="text/html" href="http://o-botics.org/news/tutorial-adding-content-to-obotics/"/>
  <id>http://o-botics.org/news/tutorial-adding-content-to-obotics</id>
  <updated>2014-05-30T00:00:00-00:00</updated>
  <published>2014-04-02T00:00:00-04:00</published>
  
  <author>
    <name>O-Botics</name>
    <uri>http://o-botics.org</uri>
    <email>rowoflo@o-botics.org</email>
  </author>
  <content type="html">&lt;p&gt;The ambition of this website is to be collaborative.
For that to happen people besides myself need to be able to contribute to the content of the site.
This tutorial explains how to contribute content to this site.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Any ideas or comments to improve the setup and organization of this site are welcome.&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Also, if you want a more detailed explanation of any of the topics below, do not hesitate to comment.&lt;/strong&gt;&lt;/p&gt;

&lt;h1 id=&quot;table-of-contents&quot;&gt;Table Of Contents&lt;/h1&gt;
&lt;ol&gt;
  &lt;li&gt;&lt;a href=&quot;#background&quot;&gt;Background&lt;/a&gt;&lt;/li&gt;
  &lt;li&gt;&lt;a href=&quot;#getting-the-repositories&quot;&gt;Getting The Repositories&lt;/a&gt;&lt;/li&gt;
  &lt;li&gt;&lt;a href=&quot;#installing-jekyll&quot;&gt;Installing Jekyll&lt;/a&gt;&lt;/li&gt;
  &lt;li&gt;&lt;a href=&quot;#testing-jekyll-site&quot;&gt;Testing Jekyll Site&lt;/a&gt;&lt;/li&gt;
  &lt;li&gt;&lt;a href=&quot;#adding-content&quot;&gt;Adding Content&lt;/a&gt;
    &lt;ul&gt;
      &lt;li&gt;&lt;a href=&quot;#adding-news&quot;&gt;Adding News&lt;/a&gt;&lt;/li&gt;
      &lt;li&gt;&lt;a href=&quot;#adding-robots&quot;&gt;Adding Robots&lt;/a&gt;&lt;/li&gt;
      &lt;li&gt;&lt;a href=&quot;#adding-roboticists&quot;&gt;Adding Roboticists&lt;/a&gt;&lt;/li&gt;
    &lt;/ul&gt;
  &lt;/li&gt;
  &lt;li&gt;&lt;a href=&quot;#publishing-new-content&quot;&gt;Publishing New Content&lt;/a&gt;&lt;/li&gt;
&lt;/ol&gt;

&lt;h1 id=&quot;background&quot;&gt;Background&lt;/h1&gt;

&lt;p&gt;Let me first describe how the site is hosted and configured.
The site is hosted as a &lt;a href=&quot;https://pages.github.com/&quot;&gt;GitHub Page&lt;/a&gt; using &lt;a href=&quot;http://jekyllrb.com/&quot;&gt;Jekyll&lt;/a&gt; to build the static web pages.&lt;/p&gt;

&lt;p&gt;What does this mean?&lt;/p&gt;

&lt;p&gt;GitHub is a web-based hosting service for &lt;a href=&quot;http://git-scm.com/&quot;&gt;Git&lt;/a&gt; (a revision control system) repositories and is where the source files for this site are stored.&lt;/p&gt;

&lt;p&gt;The source files and the actual static web pages files are in the following repositories:&lt;/p&gt;

&lt;ol&gt;
  &lt;li&gt;&lt;a href=&quot;https://github.com/o-botics/website&quot;&gt;https://github.com/o-botics/website&lt;/a&gt;&lt;/li&gt;
  &lt;li&gt;&lt;a href=&quot;https://github.com/o-botics/o-botics.github.io&quot;&gt;https://github.com/o-botics/o-botics.github.io&lt;/a&gt;&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;Some may wonder why two different repositories are being used?&lt;/p&gt;

&lt;p&gt;The source files can be stored directly in the *.github.io repository and GitHub can build the Jekyll files and deploy the resulting static pages.
The problem is that &lt;a href=&quot;http://jekyllrb.com/docs/plugins/&quot;&gt;GitHub will not build custom Jekyll plugins&lt;/a&gt;, which O’Botics uses.
Thus, the use of the two separate repositories are necessary.
The site is generated locally and pushed directly to the *.github.io repository.&lt;/p&gt;

&lt;p&gt;Jekyll is used to create the static pages from HTML and &lt;a href=&quot;http://en.wikipedia.org/wiki/Markdown&quot;&gt;Markdown&lt;/a&gt; files.
This allows to easily create new pages while maintain the similar formatting and style from the rest of the website.
For example, to create this tutorial page I had to:&lt;/p&gt;

&lt;ol&gt;
  &lt;li&gt;Create a new markdown text file (&lt;code&gt;*.md&lt;/code&gt;) in the post directory of the website folder (&lt;code&gt;.../website/_posts&lt;/code&gt;)&lt;/li&gt;
  &lt;li&gt;Name it appropriately (&lt;code&gt;YYYY-MM-DD-title.md&lt;/code&gt;)&lt;/li&gt;
  &lt;li&gt;Add a &lt;a href=&quot;http://en.wikipedia.org/wiki/YAML&quot;&gt;YAML&lt;/a&gt; header (contains the metadata about the page)&lt;/li&gt;
  &lt;li&gt;Add the content page using markdown syntax&lt;/li&gt;
  &lt;li&gt;Build the page with Jekyll (&lt;code&gt;&amp;gt;&amp;gt; jekyll build&lt;/code&gt;)&lt;/li&gt;
  &lt;li&gt;Publish the page to GitHub (&lt;code&gt;&amp;gt;&amp;gt; git commit -a &amp;amp;&amp;amp; git push&lt;/code&gt;)&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;I did not have to worry about any other HTML/CSS to give it the look and feel of the website.
It is similar to LaTeX, where the formatting is abstracted away from the content.&lt;/p&gt;

&lt;p&gt;Ok enough chitchat… how does someone else do this?&lt;/p&gt;

&lt;h1 id=&quot;getting-the-repositories&quot;&gt;Getting The Repositories&lt;/h1&gt;

&lt;ol&gt;
  &lt;li&gt;First &lt;a href=&quot;https://github.com&quot;&gt;create a GitHub account&lt;/a&gt;.&lt;/li&gt;
  &lt;li&gt;Fork the repository (Hit the “Fork” button in the upper left of the screen): &lt;a href=&quot;https://github.com/o-botics/website&quot;&gt;o-botics/website repository&lt;/a&gt;.
    &lt;ul&gt;
      &lt;li&gt;The GitHub Help page on “forking” is very useful, &lt;a href=&quot;https://help.github.com/articles/fork-a-repo&quot;&gt;Fork A Repo&lt;/a&gt;.&lt;/li&gt;
    &lt;/ul&gt;
  &lt;/li&gt;
  &lt;li&gt;Clone the &lt;em&gt;website&lt;/em&gt; repository. To do this navigate to your favorite folder and execute the following command:
&lt;code&gt;&amp;gt;&amp;gt; git clone https://github.com/USERNAME/website.git&lt;/code&gt;
    &lt;ul&gt;
      &lt;li&gt;Make sure to replace &lt;em&gt;USERNAME&lt;/em&gt; with your GitHub username.&lt;/li&gt;
    &lt;/ul&gt;
  &lt;/li&gt;
&lt;/ol&gt;

&lt;h1 id=&quot;installing-jekyll&quot;&gt;Installing Jekyll&lt;/h1&gt;
&lt;ol&gt;
  &lt;li&gt;
    &lt;p&gt;&lt;a href=&quot;https://www.ruby-lang.org/en/installation/&quot;&gt;Install Ruby&lt;/a&gt;.&lt;/p&gt;
  &lt;/li&gt;
  &lt;li&gt;Next install Jekyll with the following command: &lt;code&gt;&amp;gt;&amp;gt; gem install jekyll&lt;/code&gt;
    &lt;ul&gt;
      &lt;li&gt;Windows users this site will be helpful, &lt;a href=&quot;http://www.madhur.co.in/blog/2011/09/01/runningjekyllwindows.html&quot;&gt;Running Jekyll On Windows&lt;/a&gt;.&lt;/li&gt;
    &lt;/ul&gt;
  &lt;/li&gt;
  &lt;li&gt;This site uses Kramdown to convert the markdown to HTML. Install Kramdown with the following command: &lt;code&gt;&amp;gt;&amp;gt; gem install kramdown&lt;/code&gt;&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;or installl with bundle locally:&lt;/p&gt;

&lt;ol&gt;
  &lt;li&gt;Ubuntu we need &lt;code&gt;$ sudo apt-get install ruby-dev&lt;/code&gt;&lt;/li&gt;
  &lt;li&gt;Install bundle &lt;code&gt;$ sudo gem install bundle&lt;/code&gt;&lt;/li&gt;
  &lt;li&gt;Now we can run bundle &lt;code&gt;$ bundle&lt;/code&gt;&lt;/li&gt;
&lt;/ol&gt;

&lt;h1 id=&quot;testing-jekyll-site&quot;&gt;Testing Jekyll Site&lt;/h1&gt;
&lt;p&gt;You should now have everything you need to start adding content to the site.
To test the setup and for development, Jekyll comes with a built-in development server that allows you to preview the site locally.&lt;/p&gt;

&lt;ol&gt;
  &lt;li&gt;Navigate to the folder in which you cloned the &lt;em&gt;website&lt;/em&gt; repository into, something like &lt;code&gt;&amp;gt;&amp;gt; cd ~/.../website&lt;/code&gt;&lt;/li&gt;
  &lt;li&gt;Open the &lt;code&gt;.../website/_config.yml&lt;/code&gt; file with your favorite text editor.&lt;/li&gt;
  &lt;li&gt;Comment out the URL line (approx. line 7).
    &lt;ul&gt;
      &lt;li&gt;Should look like this: &lt;code&gt;# url: http://o-botics.org&lt;/code&gt;.
  This will set the default URL of the site to &lt;code&gt;http://localhost:4000&lt;/code&gt;.&lt;/li&gt;
    &lt;/ul&gt;
  &lt;/li&gt;
  &lt;li&gt;Build the site with Jekyll. Run the following command in the &lt;em&gt;website&lt;/em&gt; folder to do this, &lt;code&gt;&amp;gt;&amp;gt; jekyll build&lt;/code&gt;&lt;/li&gt;
  &lt;li&gt;Activate the Jekyll web server. Run the following command in the &lt;em&gt;website&lt;/em&gt; folder to do this, &lt;code&gt;&amp;gt;&amp;gt; jekyll serve&lt;/code&gt;&lt;/li&gt;
  &lt;li&gt;Check out the site in your favorite browser by navigating to &lt;code&gt;http://localhost:4000&lt;/code&gt;.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;Every time you change something you have to rebuild the site with the build command.
This can get annoying, so instead you can run &lt;code&gt;&amp;gt;&amp;gt; jekyll serve --watch&lt;/code&gt; command, which will automatically build the site if any of the files change.
Except for if the configuration file, &lt;code&gt;.../website/_config.yml&lt;/code&gt;, changes.
In that case you must use the build command, &lt;code&gt;jekyll build&lt;/code&gt;.&lt;/p&gt;

&lt;h1 id=&quot;adding-content&quot;&gt;Adding content&lt;/h1&gt;
&lt;p&gt;To add content to the site simply create a new file of the appropriate type and save it into the appropriate folder, Jekyll takes care of the rest.
Using the current files as examples is a good way to start.&lt;/p&gt;

&lt;h3 id=&quot;adding-news&quot;&gt;Adding News&lt;/h3&gt;
&lt;p&gt;To create a new post, which gets added to the “News” tab of the site follow these steps.&lt;/p&gt;

&lt;ol&gt;
  &lt;li&gt;Copy the post template file,&lt;code&gt;YYYY-MM-DD-post-title.md&lt;/code&gt;, from the &lt;code&gt;.../website/_templates/&lt;/code&gt; folder to the &lt;code&gt;.../website/_posts/&lt;/code&gt; folder.&lt;/li&gt;
  &lt;li&gt;Rename the file to current date and desired title, making sure to following the correct format. For example, &lt;code&gt;2014-02-27-hello-world.md&lt;/code&gt; is a valid name.
The date in the file name will be the creation date on the left side the website page.&lt;/li&gt;
  &lt;li&gt;Update the metadata of the post.
At the top of the file is some YAML content, which contains all of the metadata for the post.
Do not change the first two lines, but edit the following lines appropriately (see the other posts for examples).
    &lt;ul&gt;
      &lt;li&gt;The avatar picture file is relative to the &lt;code&gt;.../website/roboticists/&lt;/code&gt; folder.&lt;/li&gt;
    &lt;/ul&gt;
  &lt;/li&gt;
  &lt;li&gt;Add content below the YAML section of the file.
Do not edit the bottom of the file.
This section is the javascript that is used to display the &lt;a href=&quot;http://disqus.com/&quot;&gt;Disqus&lt;/a&gt; comments.&lt;/li&gt;
  &lt;li&gt;If you are running &lt;code&gt;&amp;gt;&amp;gt; jekyll serve --watch&lt;/code&gt;, after each time you save the file, you should see the changes appear in your browser after hitting refresh.&lt;/li&gt;
&lt;/ol&gt;

&lt;h3 id=&quot;adding-robots&quot;&gt;Adding Robots&lt;/h3&gt;
&lt;p&gt;Adding a new robot is very similar to adding a new post.
The major difference is that there is a deeper folder structure organization that is employed.
The robot folder structure is organized as follows:&lt;/p&gt;

&lt;pre&gt;&lt;code&gt;.../website/robots
              |
              -&amp;gt; Robot
                   |
                   -&amp;gt; index.md
                   -&amp;gt; Model
                         |
                         -&amp;gt; index.md
                         -&amp;gt; Version
                              |
                              -&amp;gt; index.md
                              -&amp;gt; other files

&lt;/code&gt;&lt;/pre&gt;

&lt;p&gt;The idea behind this structure is that as a robot evolves it can build off earlier versions and models.
As an example, take a look at the QuickBot robot MOOC model v1 version.&lt;/p&gt;

&lt;p&gt;To add a new robot follow these steps.&lt;/p&gt;

&lt;ol&gt;
  &lt;li&gt;Create a new robot folder in the &lt;code&gt;.../website/robots/&lt;/code&gt; folder.
    &lt;ul&gt;
      &lt;li&gt;For example &lt;code&gt;&amp;gt;&amp;gt; mkdir robots/new_robot&lt;/code&gt;&lt;/li&gt;
    &lt;/ul&gt;
  &lt;/li&gt;
  &lt;li&gt;Copy the robot template, &lt;code&gt;robot_index.md&lt;/code&gt;, from the &lt;code&gt;.../website/_templates/&lt;/code&gt; folder to your new robot folder and rename to &lt;code&gt;index.md&lt;/code&gt;.
    &lt;ul&gt;
      &lt;li&gt;For example &lt;code&gt;&amp;gt;&amp;gt; cp _templates/robot_index.md robots/new_robot/index.md&lt;/code&gt;&lt;/li&gt;
    &lt;/ul&gt;
  &lt;/li&gt;
  &lt;li&gt;Edit YAML content at the top this new robot file.
    &lt;ul&gt;
      &lt;li&gt;Do not change the first two lines of the YAML content.&lt;/li&gt;
    &lt;/ul&gt;
  &lt;/li&gt;
  &lt;li&gt;Create a new model folder in the robot folder that you just created.
    &lt;ul&gt;
      &lt;li&gt;For example &lt;code&gt;&amp;gt;&amp;gt; mkdir robots/new_robot/new_model&lt;/code&gt;&lt;/li&gt;
    &lt;/ul&gt;
  &lt;/li&gt;
  &lt;li&gt;Copy the model template, &lt;code&gt;robot_model_index.md&lt;/code&gt;, from the &lt;code&gt;.../website/_templates&lt;/code&gt; folder to your new model folder and rename to &lt;code&gt;index.md&lt;/code&gt;.
    &lt;ul&gt;
      &lt;li&gt;For example &lt;code&gt;&amp;gt;&amp;gt; cp _templates/robot_model_index.md robots/new_robot/new_model&lt;/code&gt;&lt;/li&gt;
    &lt;/ul&gt;
  &lt;/li&gt;
  &lt;li&gt;Edit YAML content at the top this new model file.
    &lt;ul&gt;
      &lt;li&gt;Do not change the first two lines of the YAML content.&lt;/li&gt;
    &lt;/ul&gt;
  &lt;/li&gt;
  &lt;li&gt;Create a new version folder in the model folder that you just created.
    &lt;ul&gt;
      &lt;li&gt;For example &lt;code&gt;&amp;gt;&amp;gt; mkdir robots/new_robot/new_model/new_version&lt;/code&gt;&lt;/li&gt;
    &lt;/ul&gt;
  &lt;/li&gt;
  &lt;li&gt;Copy the version template, &lt;code&gt;robot_model_version_index.md&lt;/code&gt;, from the &lt;code&gt;.../website/_templates&lt;/code&gt; folder to your new version folder and rename to &lt;code&gt;index.md&lt;/code&gt;.&lt;/li&gt;
  &lt;li&gt;Edit YAML content at the top this new version file.
    &lt;ul&gt;
      &lt;li&gt;Do not change the first two lines of the YAML content.&lt;/li&gt;
    &lt;/ul&gt;
  &lt;/li&gt;
  &lt;li&gt;Add the content about the robot to the version file in the content area.&lt;/li&gt;
  &lt;li&gt;Add additional files about the version of the robot by creating new version files and linking to them with the links in the YAML section at the top of the file.
    &lt;ul&gt;
      &lt;li&gt;These additional files obviously can not be named &lt;code&gt;index.md&lt;/code&gt; and must be named something else.&lt;/li&gt;
    &lt;/ul&gt;
  &lt;/li&gt;
&lt;/ol&gt;

&lt;h3 id=&quot;adding-roboticists&quot;&gt;Adding Roboticists&lt;/h3&gt;
&lt;p&gt;Adding a new roboticist is very similar to adding a new post.
All the files associated with a roboticist must be placed in an individual folder under the &lt;code&gt;.../website/roboticists/&lt;/code&gt;.&lt;/p&gt;

&lt;p&gt;To add a new roboticists follow these steps.&lt;/p&gt;

&lt;ol&gt;
  &lt;li&gt;Create a new roboticist folder in the &lt;code&gt;.../website/roboticists/&lt;/code&gt; folder and name it using your last and first name, like &lt;code&gt;last_first&lt;/code&gt;.&lt;/li&gt;
  &lt;li&gt;Copy the roboticist template, &lt;code&gt;roboticist.yaml&lt;/code&gt;, from the &lt;code&gt;.../website/_templates/&lt;/code&gt; folder to your new roboticist folder and rename to your last_first name (same name as the folder) with the ‘yml’ extension, like &lt;code&gt;last_first.yml&lt;/code&gt;.&lt;/li&gt;
  &lt;li&gt;Add an avatar image to this new folder.&lt;/li&gt;
&lt;/ol&gt;

&lt;h1 id=&quot;publishing-new-content&quot;&gt;Publishing New Content&lt;/h1&gt;
&lt;p&gt;Once you have added all your new content and checked that everything is perfect by previewing the site in your local browser then you are ready to publish to the world.&lt;/p&gt;

&lt;p&gt;Follow these steps to publish.&lt;/p&gt;

&lt;ol&gt;
  &lt;li&gt;Commit your changes to the the website Git repository with &lt;code&gt;&amp;gt;&amp;gt; git commit -am &quot;Your commit message here.&quot;&lt;/code&gt;&lt;/li&gt;
  &lt;li&gt;Push your changes with &lt;code&gt;&amp;gt;&amp;gt; git push&lt;/code&gt;.&lt;/li&gt;
  &lt;li&gt;Submit a pull request from your GitHub account.
    &lt;ul&gt;
      &lt;li&gt;Use the &lt;a href=&quot;https://help.github.com/articles/using-pull-requests&quot;&gt;GitHub Help page on “pull request”&lt;/a&gt; to learn how to do this.&lt;/li&gt;
    &lt;/ul&gt;
  &lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;One of the moderators of the O’Botics will review your pull request and (most likely) accept it. Then it will be available for the entire world to see!&lt;/p&gt;

&lt;p&gt;At the time of writing this tutorial I am the only moderator, but if you would like to be a moderator (anybody is welcome) please send me a message.&lt;/p&gt;

&lt;!-- Do not edit below this line --&gt;

&lt;div id=&quot;disqus_thread&quot;&gt;&lt;/div&gt;
&lt;script type=&quot;text/javascript&quot;&gt;
    /* * * CONFIGURATION VARIABLES: EDIT BEFORE PASTING INTO YOUR WEBPAGE * * */
    
      var disqus_shortname = &#39;o-botics&#39;; // required: replace example with your forum shortname
    

    /* * * DON&#39;T EDIT BELOW THIS LINE * * */
    (function() {
        var dsq = document.createElement(&#39;script&#39;); dsq.type = &#39;text/javascript&#39;; dsq.async = true;
        dsq.src = &#39;//&#39; + disqus_shortname + &#39;.disqus.com/embed.js&#39;;
        (document.getElementsByTagName(&#39;head&#39;)[0] || document.getElementsByTagName(&#39;body&#39;)[0]).appendChild(dsq);
    })();
&lt;/script&gt;

&lt;noscript&gt;Please enable JavaScript to view the &lt;a href=&quot;http://disqus.com/?ref_noscript&quot;&gt;comments powered by Disqus.&lt;/a&gt;&lt;/noscript&gt;
&lt;p&gt;&lt;a href=&quot;http://disqus.com&quot; class=&quot;dsq-brlink&quot;&gt;comments powered by &lt;span class=&quot;logo-disqus&quot;&gt;Disqus&lt;/span&gt;&lt;/a&gt;&lt;/p&gt;

  &lt;p&gt;&lt;a href=&quot;http://o-botics.org/news/tutorial-adding-content-to-obotics/&quot;&gt;Tutorial -- Adding Content to O'Botics&lt;/a&gt; was originally published by O-Botics at &lt;a href=&quot;http://o-botics.org&quot;&gt;O'Botics&lt;/a&gt; on April 02, 2014.&lt;/p&gt;</content>
</entry>


<entry>
  <title type="html"><![CDATA[O'Botics Up and Running]]></title>
  <link rel="alternate" type="text/html" href="http://o-botics.org/news/site-up-and-running/"/>
  <id>http://o-botics.org/news/site-up-and-running</id>
  <updated>2014-03-07T00:00:00-00:00</updated>
  <published>2014-03-07T00:00:00-05:00</published>
  
  <author>
    <name>O-Botics</name>
    <uri>http://o-botics.org</uri>
    <email>rowoflo@o-botics.org</email>
  </author>
  <content type="html">&lt;p&gt;Ok, after a lot of Googling and tweaking I finally got the website up and running with comments and everything else working.
A lot of material still needs to be added but the foundation of the site is in place.&lt;/p&gt;

&lt;p&gt;Soon I will make a post on how somebody other than myself can add content to the site.
The main idea will be to fork the website repos (there are now two repos because GitHub does not compile Jekyll plugins) add your content and then do a pull request.
The content will need to be added in one of two places.
If you want to add a new robot that will go in the robots folder, if you want to add a new roboticist that will go in the roboticists folder.
All material consist of just HTML, MD, or YAML files.
Full tutorial to come.&lt;/p&gt;

&lt;p&gt;Also, ideally I would like to move the site from GitHub hosting to something else, so an actual forum can be connected with the site, something like &lt;a href=&quot;http://www.discourse.org/&quot;&gt;Discourse&lt;/a&gt;.
This requires having dynamic pages, which can not be done with GitHub.&lt;/p&gt;

&lt;!-- Do not edit below this line --&gt;

&lt;div id=&quot;disqus_thread&quot;&gt;&lt;/div&gt;
&lt;script type=&quot;text/javascript&quot;&gt;
    /* * * CONFIGURATION VARIABLES: EDIT BEFORE PASTING INTO YOUR WEBPAGE * * */
    
      var disqus_shortname = &#39;o-botics&#39;; // required: replace example with your forum shortname
    

    /* * * DON&#39;T EDIT BELOW THIS LINE * * */
    (function() {
        var dsq = document.createElement(&#39;script&#39;); dsq.type = &#39;text/javascript&#39;; dsq.async = true;
        dsq.src = &#39;//&#39; + disqus_shortname + &#39;.disqus.com/embed.js&#39;;
        (document.getElementsByTagName(&#39;head&#39;)[0] || document.getElementsByTagName(&#39;body&#39;)[0]).appendChild(dsq);
    })();
&lt;/script&gt;

&lt;noscript&gt;Please enable JavaScript to view the &lt;a href=&quot;http://disqus.com/?ref_noscript&quot;&gt;comments powered by Disqus.&lt;/a&gt;&lt;/noscript&gt;
&lt;p&gt;&lt;a href=&quot;http://disqus.com&quot; class=&quot;dsq-brlink&quot;&gt;comments powered by &lt;span class=&quot;logo-disqus&quot;&gt;Disqus&lt;/span&gt;&lt;/a&gt;&lt;/p&gt;

  &lt;p&gt;&lt;a href=&quot;http://o-botics.org/news/site-up-and-running/&quot;&gt;O'Botics Up and Running&lt;/a&gt; was originally published by O-Botics at &lt;a href=&quot;http://o-botics.org&quot;&gt;O'Botics&lt;/a&gt; on March 07, 2014.&lt;/p&gt;</content>
</entry>


<entry>
  <title type="html"><![CDATA[Trouble Updating The Site]]></title>
  <link rel="alternate" type="text/html" href="http://o-botics.org/news/trouble-updating-site/"/>
  <id>http://o-botics.org/news/trouble-updating-site</id>
  <updated>2014-03-05T00:00:00-00:00</updated>
  <published>2014-03-05T00:00:00-05:00</published>
  
  <author>
    <name>O-Botics</name>
    <uri>http://o-botics.org</uri>
    <email>rowoflo@o-botics.org</email>
  </author>
  <content type="html">&lt;p&gt;I have spent a nontrivial amount of time trying to get the site up and running.
Most of that time was spent making it easy to add new robots and roboticists and then have those additions get automatically displayed on the appropriate pages.
This is working on my local machine but does not seem to want to work on GitHub for the world to see. This will take some debugging ;-)&lt;/p&gt;

&lt;p&gt;Do not worry the site will be up for all the world to see shortly.&lt;/p&gt;

&lt;!-- Do not edit below this line --&gt;

&lt;div id=&quot;disqus_thread&quot;&gt;&lt;/div&gt;
&lt;script type=&quot;text/javascript&quot;&gt;
    /* * * CONFIGURATION VARIABLES: EDIT BEFORE PASTING INTO YOUR WEBPAGE * * */
    
      var disqus_shortname = &#39;o-botics&#39;; // required: replace example with your forum shortname
    

    /* * * DON&#39;T EDIT BELOW THIS LINE * * */
    (function() {
        var dsq = document.createElement(&#39;script&#39;); dsq.type = &#39;text/javascript&#39;; dsq.async = true;
        dsq.src = &#39;//&#39; + disqus_shortname + &#39;.disqus.com/embed.js&#39;;
        (document.getElementsByTagName(&#39;head&#39;)[0] || document.getElementsByTagName(&#39;body&#39;)[0]).appendChild(dsq);
    })();
&lt;/script&gt;

&lt;noscript&gt;Please enable JavaScript to view the &lt;a href=&quot;http://disqus.com/?ref_noscript&quot;&gt;comments powered by Disqus.&lt;/a&gt;&lt;/noscript&gt;
&lt;p&gt;&lt;a href=&quot;http://disqus.com&quot; class=&quot;dsq-brlink&quot;&gt;comments powered by &lt;span class=&quot;logo-disqus&quot;&gt;Disqus&lt;/span&gt;&lt;/a&gt;&lt;/p&gt;

  &lt;p&gt;&lt;a href=&quot;http://o-botics.org/news/trouble-updating-site/&quot;&gt;Trouble Updating The Site&lt;/a&gt; was originally published by O-Botics at &lt;a href=&quot;http://o-botics.org&quot;&gt;O'Botics&lt;/a&gt; on March 05, 2014.&lt;/p&gt;</content>
</entry>


<entry>
  <title type="html"><![CDATA[Hello World]]></title>
  <link rel="alternate" type="text/html" href="http://o-botics.org/news/hello-world/"/>
  <id>http://o-botics.org/news/hello-world</id>
  <updated>2014-02-27T00:00:00-00:00</updated>
  <published>2014-02-27T00:00:00-05:00</published>
  
  <author>
    <name>O-Botics</name>
    <uri>http://o-botics.org</uri>
    <email>rowoflo@o-botics.org</email>
  </author>
  <content type="html">&lt;p&gt;Hello World from O’Botics.
The site is up.
Not much on it right now but hopefully that will change quickly.&lt;/p&gt;

&lt;!-- Do not edit below this line --&gt;

&lt;div id=&quot;disqus_thread&quot;&gt;&lt;/div&gt;
&lt;script type=&quot;text/javascript&quot;&gt;
    /* * * CONFIGURATION VARIABLES: EDIT BEFORE PASTING INTO YOUR WEBPAGE * * */
    
      var disqus_shortname = &#39;o-botics&#39;; // required: replace example with your forum shortname
    

    /* * * DON&#39;T EDIT BELOW THIS LINE * * */
    (function() {
        var dsq = document.createElement(&#39;script&#39;); dsq.type = &#39;text/javascript&#39;; dsq.async = true;
        dsq.src = &#39;//&#39; + disqus_shortname + &#39;.disqus.com/embed.js&#39;;
        (document.getElementsByTagName(&#39;head&#39;)[0] || document.getElementsByTagName(&#39;body&#39;)[0]).appendChild(dsq);
    })();
&lt;/script&gt;

&lt;noscript&gt;Please enable JavaScript to view the &lt;a href=&quot;http://disqus.com/?ref_noscript&quot;&gt;comments powered by Disqus.&lt;/a&gt;&lt;/noscript&gt;
&lt;p&gt;&lt;a href=&quot;http://disqus.com&quot; class=&quot;dsq-brlink&quot;&gt;comments powered by &lt;span class=&quot;logo-disqus&quot;&gt;Disqus&lt;/span&gt;&lt;/a&gt;&lt;/p&gt;

  &lt;p&gt;&lt;a href=&quot;http://o-botics.org/news/hello-world/&quot;&gt;Hello World&lt;/a&gt; was originally published by O-Botics at &lt;a href=&quot;http://o-botics.org&quot;&gt;O'Botics&lt;/a&gt; on February 27, 2014.&lt;/p&gt;</content>
</entry>

</feed>