No description
Find a file
2024-05-29 16:50:19 -05:00
.github/workflows Update to peaceiris/actions-gh-pages@v4 2024-04-08 12:26:28 -04:00
_blinka added Quartz64 2024-03-30 21:26:22 -04:00
_board fix date format, update template for clarity 2024-05-29 11:16:11 -07:00
_data Add new family 2024-05-23 16:31:40 -07:00
_includes allow custom bootloader entry instructions 2024-05-16 18:36:48 -05:00
_layouts Point to specific web installer release 2024-03-25 14:35:16 -07:00
adabot@c89a0273cb update adabot submodule 2024-05-06 09:51:14 -05:00
api Update api to output valid json instead of jsonified html 2023-12-08 15:53:52 -08:00
assets add assets, update text 2024-05-29 08:16:34 -07:00
awesome-circuitpython@016eedaaf0 update submodules 2024-03-11 08:57:10 -05:00
connect new common layout for pages, add common layout to connect page to update styling 2021-12-01 09:52:50 -06:00
contributing Fix duplicate hacktoberfest label 2022-10-06 12:34:38 -07:00
doc Update hero-images docs 2022-09-28 06:16:15 -04:00
lib/tasks rebase with upstream master, process new images 2019-06-05 14:06:29 -05:00
libraries add 9.x library bundles mentions; remove 7.x bundles mentions 2023-10-31 14:11:45 -04:00
tools check-boards: show the correct format in the error message 2024-05-29 16:50:19 -05:00
.gitignore Update CP Day URL, .gitignore. 2022-08-08 13:04:25 -04:00
.gitmodules add adabot as a submodule for CI usage 2019-04-26 14:58:59 -05:00
.tool-versions bump default ruby to 3.2.2 for users using tool-versions files (asdf, etc) 2023-10-18 11:53:13 -05:00
404.html initial commit 2018-11-07 12:04:04 -06:00
_config.yml Original images are no longer deployed 2022-10-06 11:33:29 -07:00
awesome.html new common layout for pages, add common layout to connect page to update styling 2021-12-01 09:52:50 -06:00
blinka.html Designate labels for checkbox in filters 2022-11-06 13:09:10 -06:00
CNAME Create CNAME 2019-03-08 19:53:06 -08:00
downloads.html Merge pull request #1088 from makermelissa/keywords 2022-11-14 14:23:24 -08:00
feed.html Go ahead and re-combine the two feed includes 2024-04-01 11:18:52 -05:00
Gemfile Update to Ruby 3 and add RPI CP boards 2021-11-29 18:54:06 -08:00
Gemfile.lock Bump rexml from 3.2.5 to 3.2.8 2024-05-16 18:53:06 +00:00
index.html Update based on review 2022-10-16 09:36:43 -04:00
package-lock.json Add missing boards from CircuitPython 9.1.0 2024-03-29 15:14:45 -07:00
Rakefile load images based on srcset and display smallest images possible for each viewport size 2019-06-04 12:05:55 -05:00
README.md Update README.md 2022-07-18 15:07:07 -07:00
template.md fix date format, update template for clarity 2024-05-29 11:16:11 -07:00
trademarks.html Create trademarks.html 2019-04-15 14:49:33 -04:00

CircuitPython organization site

A more detailed gude for adding a board to CircuitPython can be found in the following Adafruit Learn guide: How to add a New Board to the circuitpython.org website

To add a new board to the site:

  1. Duplicate template.md to _board/<board id>.md.
  2. Edit _board/<board id>.md according to the template's instructions.
  3. In your _board/<board id>.md you will specify a board_image. Create 3 versions of this file, in the following sizes and folder locations:
Size File Dimensions (px)
Original assets/images/orignal/{board_image} 900px+ width and 4:3 ratio width
example: 900 x 675
Large assets/images/large/{board_image} 800 x 600
Small assets/images/small/{board_image} 300 x 225

For more information on preferred images or if you prefer or must use 13:10 see Preparing the Images in the Adafruit Learn guide

  1. Create a pull request with the file changes.

To test your changes locally:

  1. You need "ruby" and "ruby-bundler" installed locally. These instructions were tested with ruby 2.5 and ruby-bundler 1.17.3 on a Debian Stretch system.
  2. As needed, git submodule update --init --recursive to fetch the submodules
  3. One time, run bundle config set path 'vendor/bundle' && bundle install
  4. Run bundle exec jekyll serve to generate the site locally
  5. Visit the displayed "server address"
  6. After most local edits, the content will be updated. You will need to reload (ctrl-r or F5) your browser