Merge branch 'main' into patch-1

Author: saltedlolly

.github/workflows/build.yml

@@ -126,6 +126,10 @@ jobs:
           HTTPS_URL: https://developer.rebble.io
           JEKYLL_ENV: production
           DOCS_URL: /tmp/docs/
+          ALGOLIA_APP_ID: ${{ secrets.ALGOLIA_APP_ID }}
+          ALGOLIA_API_KEY: ${{ secrets.ALGOLIA_API_KEY }}
+          ALGOLIA_SEARCH_KEY: ${{ secrets.ALGOLIA_SEARCH_KEY }}
+          ALGOLIA_PREFIX: developer-rebble-io-prod-
 
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v3

_config.yml

@@ -77,6 +77,15 @@ links:
 
 # Jekyll collections.
 collections:
+  community_tools:
+    output: true
+    permalink: /community/tools/:path/
+  community_apps:
+    output: true
+    permalink: /community/apps/:path/
+  community_libraries:
+    output: true
+    permalink: /community/libraries/:path/
   guides:
     output: true
     permalink: /guides/:path/
@@ -103,6 +112,27 @@ defaults:
       guide_group:
       guide_subgroup:
       menu_section: guides
+  - scope:
+      path: ""
+      type: community_tools
+    values:
+      layout: community/resource
+      menu_section: community
+      menu_subsection: tools
+  - scope:
+      path: ""
+      type: community_apps
+    values:
+      layout: community/resource
+      menu_section: community
+      menu_subsection: apps
+  - scope:
+      path: ""
+      type: community_libraries
+    values:
+      layout: community/resource
+      menu_section: community
+      menu_subsection: libraries
   - scope:
       path: ""
       type: changelogs

plugins/generator_algolia.rb

@@ -79,6 +79,7 @@ def get_config
     def generate_all
       requests = [].concat(generate_blog_posts,
                            generate_guides,
+                           generate_community_resources,
                            generate_documentation,
                            generate_none_guide_guides,
                            generate_other).compact
@@ -132,6 +133,31 @@ def generate_documentation
       end.compact
     end
 
+    def generate_community_resources
+      resources = %w[community_tools community_apps community_libraries]
+
+      resources.flat_map do |type|
+        collection = @site.collections[type]
+        return [] if collection.nil?
+
+        collection.docs.map do |resource|
+          Algolia::Search::MultipleBatchRequest.new(
+            action: 'addObject',
+            index_name: "#{@prefix}community-resources",
+            body: {
+              'objectID' => resource.url,
+              'title' => resource.data['name'],
+              'url' => resource.url,
+              'content' => HTMLEntities.new.decode(resource.get_output),
+              'resourceType' => type,
+              'type' => 'community resource',
+              'randomCode' => @random_code
+            }
+          )
+        end
+      end
+    end
+
     def generate_blog_posts
       @site.posts.docs.flat_map do |post|
         # Calculate the age of the post so we can prioritise newer posts

plugins/generator_redirects.rb

@@ -50,9 +50,13 @@ def create_old_path_redirect(page)
       if page.url.end_with?('/')
         @site.pages <<
           RedirectPage.new(@site, @site.source, "/developer.pebble.com#{page.url}", 'index.html', page.url)
+        @site.pages <<
+          RedirectPage.new(@site, @site.source, "/developer.getpebble.com#{page.url}", 'index.html', page.url)
       else
         @site.pages <<
           RedirectPage.new(@site, @site.source, File.dirname("/developer.pebble.com#{page.url}"), File.basename(page.url), page.url)
+        @site.pages <<
+          RedirectPage.new(@site, @site.source, File.dirname("/developer.getpebble.com#{page.url}"), File.basename(page.url), page.url)
       end
     end
   end

source/_community_apps/Hello.md

@@ -0,0 +1,16 @@
+---
+name: Hello
+creator: James Mattis
+license: MIT
+link: https://github.com/jamesmattis/Hello
+tags:
+  - watchapp
+  - ios
+  - messaging
+---
+
+_**Hello**_ demonstrates a fairly complete Pebble watch app appMessage implementation including error handling. It outputs a vareity of statistics, and provides convenient settings switches to control some of the app parameters and settings.
+
+The basic appMessage demo apps provided by Pebble demonstrate the key features of the App Message system, but don't illustrate all of the potential errors, warning, and errata that you might encounter on a production app trying to send high rates of data to the Pebble Watch via App Message. The Hello watch app demo attempts to provide a more thorough example. Complete details of the iOS and Watch app implementation can be found in the NOTES.md file.
+
+There is probably some silly bug in here somewhere. If you find something, let me know about it. Thanks!

source/_community_apps/caltrain.md

@@ -0,0 +1,41 @@
+---
+name: Caltrain
+creator: Katharine Berry
+license: mit
+link: https://github.com/Katharine/pebble-caltrain/
+appstore: 53eb5caf6743f7a863000201
+tags:
+  - watchapp
+  - js
+  - storage
+---
+
+Caltrain is a Pebble app that displays upcoming trains at a station, and where
+those trains will stop along the remainder of each of their routes.
+
+It stores the schedule locally in ``resources``, and makes heavy use of
+``resource_load_byte_range`` to read in the required data without running out
+of RAM. This is wrapped in a block reading API for performance reasons; without
+that it takes several seconds to load each window.
+
+It also uses [`Persistent Storage`](``Storage``) to store the state of the UI,
+so it can be restored to the state in which you left it when you return to the
+app.
+
+Finally, it uses PebbleKit JS to retrieve your location on launch. If it gets a
+response before you manually choose a station, it will automatically show the
+station closest to you.
+
+The windows were built using [CloudPebble's UI Editor][ui-editor].
+
+A python script is included to convert from the Caltrain GTFS data to the
+compressed format it uses.
+
+Screenshots:
+
+![](http://i.imgur.com/iGGxV9q.png)
+![](http://i.imgur.com/RNeaSQ1.png)
+![](http://i.imgur.com/23kD7ie.png)
+![](http://i.imgur.com/mHFaUMy.png)
+
+[ui-editor]: /blog/2014/08/08/CloudPebble-Graphical-UI-Editor/

source/_community_apps/heroboard.md

@@ -0,0 +1,15 @@
+---
+name: HeroBoard
+creator: Rodrigo Mesquita
+license: mit
+link: https://github.com/rmesquit/HeroBoard
+language: c
+appstore: 54f3398f2af981c827000058
+tags:
+  - watchapps
+  - graphics
+  - animation
+---
+Guitar Hero-based keyboard for Pebble
+
+This is a Pebble app keyboard based on the game Guitar Hero. It is NOT a final product/watchapp. It is meant to be used with T3/T9 text prediction scripts. When complete, it could be implemented as an exclusive keyboard for Pebble.

source/_community_apps/multi-timer.md

@@ -0,0 +1,32 @@
+---
+name: Multi Timer
+creator: Matthew Tole
+license: mit
+link: https://github.com/smallstoneapps/multi-timer
+appstore: 52d30a1d19412b4d84000025
+tags:
+  - watchapp
+  - js
+  - storage
+  - config
+---
+
+Multi Timer is a Pebble watchapp that allows you to run several timers and
+stopwatches simultaneously.
+
+It uses [`Persistent Storage`](``Storage``) on the watch to remember your
+timers, and even fakes the timers running in the background by calculating how
+much time has elapsed since the app was last run and adding / removing this
+amount of time from any running timers.
+
+Some parts of the C and JS code are tested, and are run automatically using
+[Travis CI][1].
+
+The current build status of the app is: [![Build Status](https://travis-ci.org/smallstoneapps/multi-timer.png?branch=master)][2]
+
+Here is what the app looks like:
+
+![Multi Timer Screenshot #1 >{pebble-screenshot,pebble-screenshot--steel-black}](https://raw.githubusercontent.com/smallstoneapps/multi-timer/master/marketing/screenshots/2.7/multi-timer_2-7_01.png)
+
+[1]: https://travis-ci.org/
+[2]: https://travis-ci.org/smallstoneapps/multi-timer/

source/_community_apps/resistor-time.md

@@ -0,0 +1,20 @@
+---
+name: Resistor Time
+creator: Ben Combee
+license: mit
+link: https://github.com/unwiredben/resistor-time
+language: c
+appstore: 55561ff444dad6e1470000df
+tags:
+  - watchface
+  - js
+  - config
+  - storage
+  - messaging
+---
+This shows the current time as a resistor with the color code matching the time of day in 24-hour time.
+
+Configuration is done through a static HTML page hosted on github pages and some PebbleKit JS code that handles
+communication with the configuration page.
+
+This only works on the Basalt color platform, as there's no point trying to show color codes on a black and white watch.

source/_community_libraries/color-select-lib.md

@@ -0,0 +1,42 @@
+---
+name: Color Selector
+creator: Jason Brand
+license: mit
+link: https://github.com/jas-b/color_select_lib/
+language: c
+---
+
+##Description
+This library opens a seperate window for color selections.
+Useful for converting existing apps to color.
+
+##Usage
+
+#### 1. Add color_sel_lib.h and color_sel_lib.c to your Pebble project.
+```c
+#include "color_sel_lib.h"
+```
+#### 2. Define a handler to use the selected color:
+```c
+void handle_CS_close(int color_argb) {
+  GColor color = (GColor){.argb = color_argb};
+  // Do something
+  
+  // or use directly
+  text_layer_set_background_color(text_layer_name, (GColor){.argb = color_argb});
+}
+```
+#### 3. Create the window and show it:
+```c
+CSWindow * myCSWindow = cswindow_create(
+  default_color, false, 
+  (CSCloseHandler)handle_CS_close);
+
+cswindow_show(myCSWindow, true);
+```
+
+|Parameter|Description|
+|---|---|
+|**default_color**|The default color that the window will try to match.|
+|**full_palette**|true to use all 64 color, false to use a subset of 11 main colors. The user can switch between the two palettes by holding the select button.|
+|**closeHandler**|The CSCloseHandler to fire when the keyboard closes.|