new section - develop

MichalSkoula · Jul 29, 2019 · b9c5af8 · b9c5af8
1 parent 9a2d686
commit b9c5af8
Show file tree

Hide file tree

Showing 18 changed files with 67 additions and 49 deletions.
diff --git a/README.md b/README.md
@@ -4,12 +4,20 @@ Build your own retro gaming console based on the Arduino platform.
 
 ## Docs
 
-You can find everything on our [official page](https://www.arco1500.com).
+You can find everything about ARCO1500 - how to get one, develop and play games on our [official page](https://www.arco1500.com).
 
-## External Links
+## Other stuff
+
+### How to build a release (developers only)
+
+1. Put source code (without *git* stuff) somewhere into a folder.
+2. Download [Arduino IDE - ZIP](https://www.arduino.cc/en/main/software#source) and extract it into "arduino" folder.
+3. Download [USB drivers](https://github.com/himalayanelixir/Arduino_USB_Drivers) and place it into "arduino/drivers" folder.
+4. Install U8G2 library via Arduino IDE.
+5. Zip that folder from step 1. and here you go.
+
+### External Links
 
 * [Online Store](https://www.en.bastlime.eu)
 * [YouTube Channel](https://www.youtube.com/playlist?list=PLZWNQlcHslXWuSwxoAaJYrSB9fYc1FXUI)
 * [Facebook page](https://www.facebook.com/ARCO-1500-494530131084329)
-
-
diff --git a/docs/_layouts/default.html b/docs/_layouts/default.html
@@ -43,10 +43,11 @@ <h2>{{ site.description | default: site.github.project_tagline }}</h2>
             <section id="downloads" class="row justify-content-between">
                 <div class="col-9">
                     <a href="/" class="btn {% if page.url == '/' %} active {% endif %}"><i class="fas fa-home"></i> Home</a>
+                    <a href="/blog.html" class="btn {% if page.url contains '/blog' %} active {% endif %}"><i class="fas fa-rss"></i> Blog</a>
                     <a href="/get.html" class="btn {% if page.url == '/get.html' %} active {% endif %}"><i class="fas fa-shopping-cart"></i> Get</a>
                     <a href="/make.html" class="btn {% if page.url == '/make.html' %} active {% endif %} "><i class="fas fa-hammer"></i> Make</a>
+                    <a href="/develop.html" class="btn {% if page.url == '/develop.html' %} active {% endif %} "><i class="fas fa-code"></i> Develop</a>
                     <a href="/play.html" class="btn {% if page.url == '/play.html' %} active {% endif %}"><i class="fas fa-gamepad"></i> Play</a>
-                    <a href="/blog.html" class="btn {% if page.url contains '/blog' %} active {% endif %}"><i class="fas fa-rss"></i> Blog</a>
                 </div>
 
                 <div class="col-3 text-right">

diff --git a/docs/assets/css/.php_cs.cache b/docs/assets/css/.php_cs.cache
@@ -0,0 +1 @@
+{"php":"7.1.22","version":"2.13.0:v2.13.0#7136aa4e0c5f912e8af82383775460d906168a10","rules":{"blank_line_after_namespace":true,"braces":true,"class_definition":true,"elseif":true,"function_declaration":true,"indentation_type":true,"line_ending":true,"lowercase_constants":true,"lowercase_keywords":true,"method_argument_space":{"on_multiline":"ensure_fully_multiline"},"no_break_comment":true,"no_closing_tag":true,"no_spaces_after_function_name":true,"no_spaces_inside_parenthesis":true,"no_trailing_whitespace":true,"no_trailing_whitespace_in_comment":true,"single_blank_line_at_eof":true,"single_class_element_per_statement":{"elements":["property"]},"single_import_per_statement":true,"single_line_after_imports":true,"switch_case_semicolon_to_colon":true,"switch_case_space":true,"visibility_required":true,"encoding":true,"full_opening_tag":true},"hashes":{"style.scss":2291615981}}
diff --git a/docs/assets/css/style.scss b/docs/assets/css/style.scss
@@ -8,7 +8,7 @@ $green: #b5e53a;
 $blue: #b0f0fd;
 $purple: #e2a2e3;
 $grey: #666;
-$white: #eaeaea;
+$white: #F6F6F6;
 
 $break-small: 768px;
 $break-large: 1200px;
@@ -79,6 +79,10 @@ h2 {
     margin-top: 1.5em;
 }
 
+h3 {
+    margin-top: 1em;
+}
+
 h1, h2, h3, h4 {
     text-transform: capitalize;
     color: $blue !important;
@@ -92,7 +96,8 @@ h1, h2, h3, h4 {
 .btn {
     border-radius: 0;
     font-size: 1.1em;
-    margin: 0 0 0.5em 0 !important;
+    padding: 5px 10px;
+    color: $white;
 
     @media screen and (max-width: $break-small) {
         font-size: 0.9em;
@@ -148,7 +153,7 @@ h1, h2, h3, h4 {
 }
 
 .image-border {
-    border: 1px dashed $blue;    
+    border: 2px dashed $blue;    
 }
 
 .github-corner:hover .octo-arm{animation:octocat-wave 560ms ease-in-out}@keyframes octocat-wave{0%,100%{transform:rotate(0)}20%,60%{transform:rotate(-25deg)}40%,80%{transform:rotate(10deg)}}@media (max-width:500px){.github-corner:hover .octo-arm{animation:none}.github-corner .octo-arm{animation:octocat-wave 560ms ease-in-out}}
diff --git a/docs/assets/images/arco-fritzing.fzz b/docs/assets/images/arco-fritzing.fzz
diff --git a/docs/assets/images/arco-fritzing.png b/docs/assets/images/arco-fritzing.png
diff --git a/docs/assets/images/arco-game-uploader.png b/docs/assets/images/arco-game-uploader.png
diff --git a/docs/assets/images/arco_game_uploader.png b/docs/assets/images/arco_game_uploader.png
diff --git a/docs/assets/images/arduino_ide_select_port.png b/docs/assets/images/arduino_ide_select_port.png
diff --git a/docs/assets/images/gamelib.png b/docs/assets/images/gamelib.png
diff --git a/docs/assets/images/hello_arco.png b/docs/assets/images/hello_arco.png
diff --git a/docs/develop.md b/docs/develop.md
@@ -3,33 +3,44 @@ layout: default
 
 ---
 
-# Develop games
+# Develop your own game!
 
-Here's how you can open and run games like a pro:
+You can develop your own games with just a little knowledge of programming (C++ / Wiring). 
 
-1. Install USB driver CH341 (arduino/drivers/Arduino_USB_Drivers-master)
-2. Open bundled Arduino IDE (arduino/arduino.exe)
-3. Run some games from games directory
+## Hello Arco
 
-You can develop your own games with just a little knowledge of programming (C++ / Wiring).
+There is this game called "Hello Arco" which is an equivalent for classic "Hello World" programs. You can use it as a boilerplate for developing your game.
 
+<img data-src="{{ '/assets/images/hello_arco.png' | prepend: site.baseurl }}" class="img-responsive float-left mr-3 image-border">
 
+The game structure is simple. There must be a folder inside the "games" directory. Then, inside the folder, there must be an .ino file with the same name as folder. This file is the main and only required file. 
 
-## Premade games (currently {{ site.data.games | size }})
+You can divide your code into several .ino files, but this is just for clarity.
 
-<div class="photo-gallery">
-    {% for image in site.data.games %}
-        <a href="{{ image.image_path }}" data-fancybox="games-gallery" data-caption="{{ image.title | escape }}">
-            <figure>
-                <img data-src="{{ image.image_path }}" alt="{{ image.title | escape }}" />
-                <figcaption>
-                    {{ image.title}}
-                </figcaption>
-            </figure>
-        </a>
-    {% endfor %}
-</div>
+<div class="clearfix"></div>
 
+## Arduino IDE
 
+You load the main file "hello_arco.ino" into Arduino IDE. But wait, before uploading it to console, you must specify a port to which your console is connected.
+
+<img data-src=" {{ '/assets/images/arduino_ide_select_port.png' | prepend: site.baseurl }}" class="img-responsive image-border">
+
+<div class="clearfix"></div>
+
+## Gamelib
+
+<img data-src="{{ '/assets/images/gamelib.png' | prepend: site.baseurl }}" class="img-responsive float-left mr-3 image-border">
+
+This is our (optional to use) library which can help you create better games. 
+
+It comes with simple interfaces - drawing on display, playing sounds, dealing with user inputs and score. 
+
+You can find it in "arduino/portable/sketchbook/libraries/gamelib".
+
+<div class="clearfix"></div>
+
+## Emulator
+
+For Linux users out there, we have an emulator. You can find it in "not_emulator" folder. There is a README.md file with simple instructions on how to use it.
 
 ## [<< Make](/make.html) | Develop | [Play >>](/play.html)
diff --git a/docs/get.md b/docs/get.md
@@ -3,15 +3,13 @@ layout: default
 
 ---
 
-# Get ARCO 1500
-
-## Buy ARCO 1500 Complete set
+# Buy ARCO 1500 Complete set
 
 You can buy a nice, complete set and start in a few minutes. Visit our <a href="{{ site.bastlime_url }}">store</a>.
 
 [image]
 
-## .. or Make it with your own parts
+# .. or Make it with your own parts
 
 ARCO 1500 is an **open source project**, so you can take the source and make it your own. All you need is some affordable electronic parts and our 3D printed case (optional). No PCB, soldering. Here is the list of components: 
 

diff --git a/docs/index.md b/docs/index.md
@@ -7,7 +7,9 @@ layout: default
 
 <div class="row">
     <div class="col-sm">
-        <img data-src="/assets/images/prototypes/thumbnails/{{ site.data.prototypes.first.filename }}" alt="{{ image.title | escape }}" class="image-border" />
+        <a href="/assets/images/prototypes/{{ site.data.prototypes.first.filename }}" data-fancybox="main-image" data-caption="ARCO 1500">
+            <img data-src="/assets/images/prototypes/thumbnails/{{ site.data.prototypes.first.filename }}" alt="{{ image.title | escape }}" class="image-border" />
+        </a>
     </div>
     <div class="col-sm">
         <p>ARCO 1500 is an open source, 8 bit DIY gaming console - both software and hardware. It comes with:</p>

diff --git a/docs/make.md b/docs/make.md
@@ -11,7 +11,7 @@ Building a console is a breeze. On the image below you can see the picture of th
 The next step is to place everything in a ready-made, 3D printed console. Both breadboard and Arduino just snap into the brackets. 
 Glue the battery holder to the bottom and route the cable through the hole in the side.
 
-<img data-src="{{ '/assets/images/arco-fritzing.png' | prepend: site.baseurl }}" class="img-responsive">
+<img data-src="{{ '/assets/images/arco-fritzing.png' | prepend: site.baseurl }}" class="img-responsive image-border">
 
 
-## [<< Get](/get.html) | Make | [Play >>](/play.html)
+## [<< Get](/get.html) | Make | [Develop >>](/develop.html)
diff --git a/docs/play.md b/docs/play.md
@@ -3,22 +3,22 @@ layout: default
 
 ---
 
-# Play and develop games
+# How to upload games and play
 
-## Prerequisities
+## Prerequisites
 
-1. Download latest release of ARCO software from [GitHub]({{ site.github_url }}releases).
+1. Download latest release of ARCO software from [GitHub]({{site.github_url}}releases).
 2. Extract it somewhere.
-2. And install USB driver "arduino/drivers/Arduino_USB_Drivers-master" (Windows only).
+2. And install corresponding USB driver "arduino/drivers/Arduino_USB_Drivers-master" (Windows only).
 
-## Use upload app to smoothly upload games
+## Use Game Uploader to smoothly upload games to console
 
 This option is the fastest way to get games to your game console and play (Windows only)!
 
 1. Connect your game console to PC with USB cable
 2. Run "game_uploader/game_uploader.exe"
 
-<img data-src="{{ '/assets/images/arco-game-uploader.png' | prepend: site.baseurl }}" class="img-responsive">
+<img data-src="{{ '/assets/images/arco_game_uploader.png' | prepend: site.baseurl }}" class="img-responsive image-border">
 
 ## Use Arduino IDE
 
@@ -33,8 +33,4 @@ Then you should use Arduino IDE:
 1. Open bundled Arduino IDE "arduino/arduino.exe"
 3. Run some games from the "games" directory
 
-You can develop your own games with just a little knowledge of programming (C++ / Wiring). 
-There is also game called "Hello Arco" which is an equivalent for classic "Hello World" programs.
-
-
-##  [<< Make](/make.html) | Play
+##  [<< Develop](/develop.html) | Play
diff --git a/games/hello_arco/assets/player.xbm b/games/hello_arco/assets/player.xbm
diff --git a/games/hello_arco/assets/player.xcf b/games/hello_arco/assets/player.xcf