From 26fe62dbf00b5c13e2a4f8ff478ff1c1ad820333 Mon Sep 17 00:00:00 2001 From: dynamis Date: Wed, 24 Jul 2019 23:45:50 +0900 Subject: [PATCH] i18n with polyglot plugin --- Gemfile | 2 + _config.yml | 13 +++ _redirects | 2 + raspi3/{ja => }/appendix0.md | 0 raspi3/{ja => }/debug.md | 0 raspi3/{ja => }/deprecated.md | 0 raspi3/{ja => }/faq.md | 0 raspi3/{ja => }/hellorealworld.md | 0 raspi3/{ja => }/imgs/favicon.ico | Bin .../imgs/section0/CHIRIMENforRaspberryPi3.png | Bin .../CHIRIMENforRaspberryPi3desktop.png | Bin .../{ja => }/imgs/section0/JSBinLexample.png | Bin raspi3/{ja => }/imgs/section0/L.gif | Bin raspi3/{ja => }/imgs/section0/L.jpg | Bin raspi3/{ja => }/imgs/section0/L.mp4 | Bin raspi3/{ja => }/imgs/section0/L.png | Bin raspi3/{ja => }/imgs/section0/Raspi3.jpg | Bin raspi3/{ja => }/imgs/section0/Raspi3.png | Bin raspi3/{ja => }/imgs/section0/Raspi3PIN.png | Bin raspi3/{ja => }/imgs/section0/b.png | Bin raspi3/{ja => }/imgs/section0/bookmark.png | Bin raspi3/{ja => }/imgs/section0/browser.png | Bin .../{ja => }/imgs/section0/example-files.png | Bin .../imgs/section0/example_LEDblink.png | Bin raspi3/{ja => }/imgs/section0/h.jpg | Bin raspi3/{ja => }/imgs/section0/h.png | Bin raspi3/{ja => }/imgs/section0/h2.jpg | Bin raspi3/{ja => }/imgs/section0/readme.md | 0 raspi3/{ja => }/imgs/section0/s.png | Bin raspi3/{ja => }/imgs/section0/wifi.png | Bin raspi3/{ja => }/imgs/section1/DC.jpg | Bin raspi3/{ja => }/imgs/section1/DC2.jpg | Bin raspi3/{ja => }/imgs/section1/DC3.fzz | Bin raspi3/{ja => }/imgs/section1/DC3.png | Bin raspi3/{ja => }/imgs/section1/DC3motor.fzz | Bin raspi3/{ja => }/imgs/section1/DC3motor.png | Bin raspi3/{ja => }/imgs/section1/DC4.jpg | Bin raspi3/{ja => }/imgs/section1/DCFan-Movie.gif | Bin raspi3/{ja => }/imgs/section1/DCFan-Movie.mp4 | Bin raspi3/{ja => }/imgs/section1/JSFiddle.png | Bin raspi3/{ja => }/imgs/section1/LEDOnOff.gif | Bin raspi3/{ja => }/imgs/section1/LEDOnOff.mp4 | Bin raspi3/{ja => }/imgs/section1/PullupPort.png | Bin raspi3/{ja => }/imgs/section1/b.jpg | Bin raspi3/{ja => }/imgs/section1/b.png | Bin raspi3/{ja => }/imgs/section1/b2.jpg | Bin raspi3/{ja => }/imgs/section1/b2.png | Bin raspi3/{ja => }/imgs/section1/chibigear_1.jpg | Bin raspi3/{ja => }/imgs/section1/chibigear_2.jpg | Bin raspi3/{ja => }/imgs/section1/dcfan.png | Bin raspi3/{ja => }/imgs/section1/k.png | Bin raspi3/{ja => }/imgs/section1/mosfet.png | Bin raspi3/{ja => }/imgs/section1/parts.jpg | Bin raspi3/{ja => }/imgs/section1/readme.md | 0 raspi3/{ja => }/imgs/section1/s.png | Bin raspi3/{ja => }/imgs/section1/s2.png | Bin raspi3/{ja => }/imgs/section1/t.jpg | Bin raspi3/{ja => }/imgs/section1/t.png | Bin raspi3/{ja => }/imgs/section1/tactswitch.fzz | Bin raspi3/{ja => }/imgs/section1/tactswitch.png | Bin raspi3/{ja => }/imgs/section2/ADT7410.png | Bin raspi3/{ja => }/imgs/section2/ADT7410OFF.png | Bin raspi3/{ja => }/imgs/section2/I2C.png | Bin .../imgs/section2/I2CBusAddressOptions.png | Bin raspi3/{ja => }/imgs/section2/browser.png | Bin raspi3/{ja => }/imgs/section2/i2c-bus.png | Bin raspi3/{ja => }/imgs/section2/i2c-bus2.png | Bin raspi3/{ja => }/imgs/section2/parts.jpg | Bin raspi3/{ja => }/imgs/section2/parts.png | Bin raspi3/{ja => }/imgs/section2/readme.md | 0 raspi3/{ja => }/imgs/section2/schematic.png | Bin .../{ja => }/imgs/section2/schematic_S2.fzz | Bin .../imgs/section2/schematic_warning.png | Bin .../imgs/section2/temperature_real.jpg | Bin .../{ja => }/imgs/section3/VL53L0X_comp.jpg | Bin raspi3/{ja => }/imgs/section3/h.jpg | Bin raspi3/{ja => }/imgs/section3/h.png | Bin raspi3/{ja => }/imgs/section3/k.png | Bin raspi3/{ja => }/imgs/section3/k2.png | Bin raspi3/{ja => }/imgs/section3/k3.jpg | Bin raspi3/{ja => }/imgs/section3/k3.png | Bin raspi3/{ja => }/imgs/section3/k4.png | Bin raspi3/{ja => }/imgs/section3/readme.md | 0 raspi3/{ja => }/imgs/section4/parts-1.jpg | Bin raspi3/{ja => }/imgs/section4/parts-1.png | Bin raspi3/{ja => }/imgs/section4/readme.md | 0 raspi3/{ja => }/imgs/section4/schematic.png | Bin raspi3/{ja => }/imgs/section5/bledemo1.jpg | Bin raspi3/{ja => }/imgs/section5/bledemo2.png | Bin raspi3/{ja => }/imgs/section5/bledemo3.png | Bin raspi3/{ja => }/imgs/section5/bledemo4.png | Bin raspi3/{ja => }/imgs/section5/bledemo5.jpeg | Bin raspi3/{ja => }/imgs/section5/blemov.mp4 | Bin raspi3/{ja => }/imgs/section5/blemov.png | Bin raspi3/{ja => }/imgs/section5/readme.md | 0 raspi3/{ja => }/imgs/section6/i1.jpg | Bin raspi3/{ja => }/imgs/section6/i2.png | Bin raspi3/{ja => }/imgs/section6/i3.png | Bin raspi3/{ja => }/imgs/section6/i4.png | Bin raspi3/{ja => }/imgs/section6/i5.png | Bin raspi3/{ja => }/imgs/section6/i6.png | Bin raspi3/{ja => }/imgs/section6/i7.png | Bin raspi3/{ja => }/imgs/section6/readme.md | 0 .../{ja => }/imgs/starterkit/starterkit.jpg | Bin .../{ja => }/imgs/starterkit/starterset.jpg | Bin raspi3/ja/readme.md | 98 ---------------- raspi3/{en/readme.md => readme-en.md} | 5 + raspi3/readme.md | 106 +++++++++++++++++- raspi3/{ja => }/sdcard.md | 0 raspi3/{en/section0.md => section0-en.md} | 6 + raspi3/{ja => }/section0.md | 2 + raspi3/{ja => }/section1.md | 0 raspi3/{ja => }/section2.md | 0 raspi3/{ja => }/section3.md | 0 raspi3/{ja => }/section4.md | 0 raspi3/{ja => }/section5.md | 0 raspi3/{ja => }/section6.md | 0 raspi3/{ja => }/teacher.md | 0 raspi3/{ja => }/tips.md | 0 119 files changed, 132 insertions(+), 102 deletions(-) rename raspi3/{ja => }/appendix0.md (100%) rename raspi3/{ja => }/debug.md (100%) rename raspi3/{ja => }/deprecated.md (100%) rename raspi3/{ja => }/faq.md (100%) rename raspi3/{ja => }/hellorealworld.md (100%) rename raspi3/{ja => }/imgs/favicon.ico (100%) rename raspi3/{ja => }/imgs/section0/CHIRIMENforRaspberryPi3.png (100%) rename raspi3/{ja => }/imgs/section0/CHIRIMENforRaspberryPi3desktop.png (100%) rename raspi3/{ja => }/imgs/section0/JSBinLexample.png (100%) rename raspi3/{ja => }/imgs/section0/L.gif (100%) rename raspi3/{ja => }/imgs/section0/L.jpg (100%) rename raspi3/{ja => }/imgs/section0/L.mp4 (100%) rename raspi3/{ja => }/imgs/section0/L.png (100%) rename raspi3/{ja => }/imgs/section0/Raspi3.jpg (100%) rename raspi3/{ja => }/imgs/section0/Raspi3.png (100%) rename raspi3/{ja => }/imgs/section0/Raspi3PIN.png (100%) rename raspi3/{ja => }/imgs/section0/b.png (100%) rename raspi3/{ja => }/imgs/section0/bookmark.png (100%) rename raspi3/{ja => }/imgs/section0/browser.png (100%) rename raspi3/{ja => }/imgs/section0/example-files.png (100%) rename raspi3/{ja => }/imgs/section0/example_LEDblink.png (100%) rename raspi3/{ja => }/imgs/section0/h.jpg (100%) rename raspi3/{ja => }/imgs/section0/h.png (100%) rename raspi3/{ja => }/imgs/section0/h2.jpg (100%) rename raspi3/{ja => }/imgs/section0/readme.md (100%) rename raspi3/{ja => }/imgs/section0/s.png (100%) rename raspi3/{ja => }/imgs/section0/wifi.png (100%) rename raspi3/{ja => }/imgs/section1/DC.jpg (100%) rename raspi3/{ja => }/imgs/section1/DC2.jpg (100%) rename raspi3/{ja => }/imgs/section1/DC3.fzz (100%) rename raspi3/{ja => }/imgs/section1/DC3.png (100%) rename raspi3/{ja => }/imgs/section1/DC3motor.fzz (100%) rename raspi3/{ja => }/imgs/section1/DC3motor.png (100%) rename raspi3/{ja => }/imgs/section1/DC4.jpg (100%) rename raspi3/{ja => }/imgs/section1/DCFan-Movie.gif (100%) rename raspi3/{ja => }/imgs/section1/DCFan-Movie.mp4 (100%) rename raspi3/{ja => }/imgs/section1/JSFiddle.png (100%) rename raspi3/{ja => }/imgs/section1/LEDOnOff.gif (100%) rename raspi3/{ja => }/imgs/section1/LEDOnOff.mp4 (100%) rename raspi3/{ja => }/imgs/section1/PullupPort.png (100%) rename raspi3/{ja => }/imgs/section1/b.jpg (100%) rename raspi3/{ja => }/imgs/section1/b.png (100%) rename raspi3/{ja => }/imgs/section1/b2.jpg (100%) rename raspi3/{ja => }/imgs/section1/b2.png (100%) rename raspi3/{ja => }/imgs/section1/chibigear_1.jpg (100%) rename raspi3/{ja => }/imgs/section1/chibigear_2.jpg (100%) rename raspi3/{ja => }/imgs/section1/dcfan.png (100%) rename raspi3/{ja => }/imgs/section1/k.png (100%) rename raspi3/{ja => }/imgs/section1/mosfet.png (100%) rename raspi3/{ja => }/imgs/section1/parts.jpg (100%) rename raspi3/{ja => }/imgs/section1/readme.md (100%) rename raspi3/{ja => }/imgs/section1/s.png (100%) rename raspi3/{ja => }/imgs/section1/s2.png (100%) rename raspi3/{ja => }/imgs/section1/t.jpg (100%) rename raspi3/{ja => }/imgs/section1/t.png (100%) rename raspi3/{ja => }/imgs/section1/tactswitch.fzz (100%) rename raspi3/{ja => }/imgs/section1/tactswitch.png (100%) rename raspi3/{ja => }/imgs/section2/ADT7410.png (100%) rename raspi3/{ja => }/imgs/section2/ADT7410OFF.png (100%) rename raspi3/{ja => }/imgs/section2/I2C.png (100%) rename raspi3/{ja => }/imgs/section2/I2CBusAddressOptions.png (100%) rename raspi3/{ja => }/imgs/section2/browser.png (100%) rename raspi3/{ja => }/imgs/section2/i2c-bus.png (100%) rename raspi3/{ja => }/imgs/section2/i2c-bus2.png (100%) rename raspi3/{ja => }/imgs/section2/parts.jpg (100%) rename raspi3/{ja => }/imgs/section2/parts.png (100%) rename raspi3/{ja => }/imgs/section2/readme.md (100%) rename raspi3/{ja => }/imgs/section2/schematic.png (100%) rename raspi3/{ja => }/imgs/section2/schematic_S2.fzz (100%) rename raspi3/{ja => }/imgs/section2/schematic_warning.png (100%) rename raspi3/{ja => }/imgs/section2/temperature_real.jpg (100%) rename raspi3/{ja => }/imgs/section3/VL53L0X_comp.jpg (100%) rename raspi3/{ja => }/imgs/section3/h.jpg (100%) rename raspi3/{ja => }/imgs/section3/h.png (100%) rename raspi3/{ja => }/imgs/section3/k.png (100%) rename raspi3/{ja => }/imgs/section3/k2.png (100%) rename raspi3/{ja => }/imgs/section3/k3.jpg (100%) rename raspi3/{ja => }/imgs/section3/k3.png (100%) rename raspi3/{ja => }/imgs/section3/k4.png (100%) rename raspi3/{ja => }/imgs/section3/readme.md (100%) rename raspi3/{ja => }/imgs/section4/parts-1.jpg (100%) rename raspi3/{ja => }/imgs/section4/parts-1.png (100%) rename raspi3/{ja => }/imgs/section4/readme.md (100%) rename raspi3/{ja => }/imgs/section4/schematic.png (100%) rename raspi3/{ja => }/imgs/section5/bledemo1.jpg (100%) rename raspi3/{ja => }/imgs/section5/bledemo2.png (100%) rename raspi3/{ja => }/imgs/section5/bledemo3.png (100%) rename raspi3/{ja => }/imgs/section5/bledemo4.png (100%) rename raspi3/{ja => }/imgs/section5/bledemo5.jpeg (100%) rename raspi3/{ja => }/imgs/section5/blemov.mp4 (100%) rename raspi3/{ja => }/imgs/section5/blemov.png (100%) rename raspi3/{ja => }/imgs/section5/readme.md (100%) rename raspi3/{ja => }/imgs/section6/i1.jpg (100%) rename raspi3/{ja => }/imgs/section6/i2.png (100%) rename raspi3/{ja => }/imgs/section6/i3.png (100%) rename raspi3/{ja => }/imgs/section6/i4.png (100%) rename raspi3/{ja => }/imgs/section6/i5.png (100%) rename raspi3/{ja => }/imgs/section6/i6.png (100%) rename raspi3/{ja => }/imgs/section6/i7.png (100%) rename raspi3/{ja => }/imgs/section6/readme.md (100%) rename raspi3/{ja => }/imgs/starterkit/starterkit.jpg (100%) rename raspi3/{ja => }/imgs/starterkit/starterset.jpg (100%) delete mode 100644 raspi3/ja/readme.md rename raspi3/{en/readme.md => readme-en.md} (96%) rename raspi3/{ja => }/sdcard.md (100%) rename raspi3/{en/section0.md => section0-en.md} (99%) rename raspi3/{ja => }/section0.md (99%) rename raspi3/{ja => }/section1.md (100%) rename raspi3/{ja => }/section2.md (100%) rename raspi3/{ja => }/section3.md (100%) rename raspi3/{ja => }/section4.md (100%) rename raspi3/{ja => }/section5.md (100%) rename raspi3/{ja => }/section6.md (100%) rename raspi3/{ja => }/teacher.md (100%) rename raspi3/{ja => }/tips.md (100%) diff --git a/Gemfile b/Gemfile index a9adc26b..d2b39d49 100644 --- a/Gemfile +++ b/Gemfile @@ -4,4 +4,6 @@ source 'https://rubygems.org' group :jekyll_plugins do gem 'github-pages' gem 'jekyll-cloudinary' + gem 'jekyll-polyglot' + gem 'jemoji' end diff --git a/_config.yml b/_config.yml index 733d3086..97d80f7f 100644 --- a/_config.yml +++ b/_config.yml @@ -12,6 +12,12 @@ show_downloads: false include: - _redirects +# configs for GitHub Pages defult plugins +# https://help.github.com/en/articles/configuring-jekyll-plugins +# https://github.com/benbalter/jekyll-readme-index +readme_index: + remove_originals: true + # Use CommonMarkGhPages for Markdown parser (after v172) # https://github.com/github/jekyll-commonmark-ghpages # https://github.com/github/pages-gem/releases/tag/v172 @@ -35,6 +41,13 @@ commonmark: # syntax_highlighter: rouge # gfm_quirks: paragraph_end +# Polyglot: Multilingual (i18n) support +# https://github.com/untra/polyglot +languages: ["ja", "en"] +default_lang: "ja" +exclude_from_localization: ["assets", "raspi3/examples"] +parallel_localization: true + # Jekyll Cloudinary Liquid tag plug-in # https://nhoizey.github.io/jekyll-cloudinary/ # https://cloudinary.com/blog/how_i_used_cloudinary_to_solve_responsive_image_needs_in_my_jekyll_website_and_shared_the_magic_in_a_plugin diff --git a/_redirects b/_redirects index a2c95e53..66ca1432 100644 --- a/_redirects +++ b/_redirects @@ -9,3 +9,5 @@ https://tutorial-chirimen-org.netlify.com/* https://tutorial.chirimen.org/:spl # redirect from obsolete path to new path /raspberrypi/* /raspi3/:splat +/raspi3/ja/* /raspi3/:splat +/raspi3/en/* /en/raspi3/:splat diff --git a/raspi3/ja/appendix0.md b/raspi3/appendix0.md similarity index 100% rename from raspi3/ja/appendix0.md rename to raspi3/appendix0.md diff --git a/raspi3/ja/debug.md b/raspi3/debug.md similarity index 100% rename from raspi3/ja/debug.md rename to raspi3/debug.md diff --git a/raspi3/ja/deprecated.md b/raspi3/deprecated.md similarity index 100% rename from raspi3/ja/deprecated.md rename to raspi3/deprecated.md diff --git a/raspi3/ja/faq.md b/raspi3/faq.md similarity index 100% rename from raspi3/ja/faq.md rename to raspi3/faq.md diff --git a/raspi3/ja/hellorealworld.md b/raspi3/hellorealworld.md similarity index 100% rename from raspi3/ja/hellorealworld.md rename to raspi3/hellorealworld.md diff --git a/raspi3/ja/imgs/favicon.ico b/raspi3/imgs/favicon.ico similarity index 100% rename from raspi3/ja/imgs/favicon.ico rename to raspi3/imgs/favicon.ico diff --git a/raspi3/ja/imgs/section0/CHIRIMENforRaspberryPi3.png b/raspi3/imgs/section0/CHIRIMENforRaspberryPi3.png similarity index 100% rename from raspi3/ja/imgs/section0/CHIRIMENforRaspberryPi3.png rename to raspi3/imgs/section0/CHIRIMENforRaspberryPi3.png diff --git a/raspi3/ja/imgs/section0/CHIRIMENforRaspberryPi3desktop.png b/raspi3/imgs/section0/CHIRIMENforRaspberryPi3desktop.png similarity index 100% rename from raspi3/ja/imgs/section0/CHIRIMENforRaspberryPi3desktop.png rename to raspi3/imgs/section0/CHIRIMENforRaspberryPi3desktop.png diff --git a/raspi3/ja/imgs/section0/JSBinLexample.png b/raspi3/imgs/section0/JSBinLexample.png similarity index 100% rename from raspi3/ja/imgs/section0/JSBinLexample.png rename to raspi3/imgs/section0/JSBinLexample.png diff --git a/raspi3/ja/imgs/section0/L.gif b/raspi3/imgs/section0/L.gif similarity index 100% rename from raspi3/ja/imgs/section0/L.gif rename to raspi3/imgs/section0/L.gif diff --git a/raspi3/ja/imgs/section0/L.jpg b/raspi3/imgs/section0/L.jpg similarity index 100% rename from raspi3/ja/imgs/section0/L.jpg rename to raspi3/imgs/section0/L.jpg diff --git a/raspi3/ja/imgs/section0/L.mp4 b/raspi3/imgs/section0/L.mp4 similarity index 100% rename from raspi3/ja/imgs/section0/L.mp4 rename to raspi3/imgs/section0/L.mp4 diff --git a/raspi3/ja/imgs/section0/L.png b/raspi3/imgs/section0/L.png similarity index 100% rename from raspi3/ja/imgs/section0/L.png rename to raspi3/imgs/section0/L.png diff --git a/raspi3/ja/imgs/section0/Raspi3.jpg b/raspi3/imgs/section0/Raspi3.jpg similarity index 100% rename from raspi3/ja/imgs/section0/Raspi3.jpg rename to raspi3/imgs/section0/Raspi3.jpg diff --git a/raspi3/ja/imgs/section0/Raspi3.png b/raspi3/imgs/section0/Raspi3.png similarity index 100% rename from raspi3/ja/imgs/section0/Raspi3.png rename to raspi3/imgs/section0/Raspi3.png diff --git a/raspi3/ja/imgs/section0/Raspi3PIN.png b/raspi3/imgs/section0/Raspi3PIN.png similarity index 100% rename from raspi3/ja/imgs/section0/Raspi3PIN.png rename to raspi3/imgs/section0/Raspi3PIN.png diff --git a/raspi3/ja/imgs/section0/b.png b/raspi3/imgs/section0/b.png similarity index 100% rename from raspi3/ja/imgs/section0/b.png rename to raspi3/imgs/section0/b.png diff --git a/raspi3/ja/imgs/section0/bookmark.png b/raspi3/imgs/section0/bookmark.png similarity index 100% rename from raspi3/ja/imgs/section0/bookmark.png rename to raspi3/imgs/section0/bookmark.png diff --git a/raspi3/ja/imgs/section0/browser.png b/raspi3/imgs/section0/browser.png similarity index 100% rename from raspi3/ja/imgs/section0/browser.png rename to raspi3/imgs/section0/browser.png diff --git a/raspi3/ja/imgs/section0/example-files.png b/raspi3/imgs/section0/example-files.png similarity index 100% rename from raspi3/ja/imgs/section0/example-files.png rename to raspi3/imgs/section0/example-files.png diff --git a/raspi3/ja/imgs/section0/example_LEDblink.png b/raspi3/imgs/section0/example_LEDblink.png similarity index 100% rename from raspi3/ja/imgs/section0/example_LEDblink.png rename to raspi3/imgs/section0/example_LEDblink.png diff --git a/raspi3/ja/imgs/section0/h.jpg b/raspi3/imgs/section0/h.jpg similarity index 100% rename from raspi3/ja/imgs/section0/h.jpg rename to raspi3/imgs/section0/h.jpg diff --git a/raspi3/ja/imgs/section0/h.png b/raspi3/imgs/section0/h.png similarity index 100% rename from raspi3/ja/imgs/section0/h.png rename to raspi3/imgs/section0/h.png diff --git a/raspi3/ja/imgs/section0/h2.jpg b/raspi3/imgs/section0/h2.jpg similarity index 100% rename from raspi3/ja/imgs/section0/h2.jpg rename to raspi3/imgs/section0/h2.jpg diff --git a/raspi3/ja/imgs/section0/readme.md b/raspi3/imgs/section0/readme.md similarity index 100% rename from raspi3/ja/imgs/section0/readme.md rename to raspi3/imgs/section0/readme.md diff --git a/raspi3/ja/imgs/section0/s.png b/raspi3/imgs/section0/s.png similarity index 100% rename from raspi3/ja/imgs/section0/s.png rename to raspi3/imgs/section0/s.png diff --git a/raspi3/ja/imgs/section0/wifi.png b/raspi3/imgs/section0/wifi.png similarity index 100% rename from raspi3/ja/imgs/section0/wifi.png rename to raspi3/imgs/section0/wifi.png diff --git a/raspi3/ja/imgs/section1/DC.jpg b/raspi3/imgs/section1/DC.jpg similarity index 100% rename from raspi3/ja/imgs/section1/DC.jpg rename to raspi3/imgs/section1/DC.jpg diff --git a/raspi3/ja/imgs/section1/DC2.jpg b/raspi3/imgs/section1/DC2.jpg similarity index 100% rename from raspi3/ja/imgs/section1/DC2.jpg rename to raspi3/imgs/section1/DC2.jpg diff --git a/raspi3/ja/imgs/section1/DC3.fzz b/raspi3/imgs/section1/DC3.fzz similarity index 100% rename from raspi3/ja/imgs/section1/DC3.fzz rename to raspi3/imgs/section1/DC3.fzz diff --git a/raspi3/ja/imgs/section1/DC3.png b/raspi3/imgs/section1/DC3.png similarity index 100% rename from raspi3/ja/imgs/section1/DC3.png rename to raspi3/imgs/section1/DC3.png diff --git a/raspi3/ja/imgs/section1/DC3motor.fzz b/raspi3/imgs/section1/DC3motor.fzz similarity index 100% rename from raspi3/ja/imgs/section1/DC3motor.fzz rename to raspi3/imgs/section1/DC3motor.fzz diff --git a/raspi3/ja/imgs/section1/DC3motor.png b/raspi3/imgs/section1/DC3motor.png similarity index 100% rename from raspi3/ja/imgs/section1/DC3motor.png rename to raspi3/imgs/section1/DC3motor.png diff --git a/raspi3/ja/imgs/section1/DC4.jpg b/raspi3/imgs/section1/DC4.jpg similarity index 100% rename from raspi3/ja/imgs/section1/DC4.jpg rename to raspi3/imgs/section1/DC4.jpg diff --git a/raspi3/ja/imgs/section1/DCFan-Movie.gif b/raspi3/imgs/section1/DCFan-Movie.gif similarity index 100% rename from raspi3/ja/imgs/section1/DCFan-Movie.gif rename to raspi3/imgs/section1/DCFan-Movie.gif diff --git a/raspi3/ja/imgs/section1/DCFan-Movie.mp4 b/raspi3/imgs/section1/DCFan-Movie.mp4 similarity index 100% rename from raspi3/ja/imgs/section1/DCFan-Movie.mp4 rename to raspi3/imgs/section1/DCFan-Movie.mp4 diff --git a/raspi3/ja/imgs/section1/JSFiddle.png b/raspi3/imgs/section1/JSFiddle.png similarity index 100% rename from raspi3/ja/imgs/section1/JSFiddle.png rename to raspi3/imgs/section1/JSFiddle.png diff --git a/raspi3/ja/imgs/section1/LEDOnOff.gif b/raspi3/imgs/section1/LEDOnOff.gif similarity index 100% rename from raspi3/ja/imgs/section1/LEDOnOff.gif rename to raspi3/imgs/section1/LEDOnOff.gif diff --git a/raspi3/ja/imgs/section1/LEDOnOff.mp4 b/raspi3/imgs/section1/LEDOnOff.mp4 similarity index 100% rename from raspi3/ja/imgs/section1/LEDOnOff.mp4 rename to raspi3/imgs/section1/LEDOnOff.mp4 diff --git a/raspi3/ja/imgs/section1/PullupPort.png b/raspi3/imgs/section1/PullupPort.png similarity index 100% rename from raspi3/ja/imgs/section1/PullupPort.png rename to raspi3/imgs/section1/PullupPort.png diff --git a/raspi3/ja/imgs/section1/b.jpg b/raspi3/imgs/section1/b.jpg similarity index 100% rename from raspi3/ja/imgs/section1/b.jpg rename to raspi3/imgs/section1/b.jpg diff --git a/raspi3/ja/imgs/section1/b.png b/raspi3/imgs/section1/b.png similarity index 100% rename from raspi3/ja/imgs/section1/b.png rename to raspi3/imgs/section1/b.png diff --git a/raspi3/ja/imgs/section1/b2.jpg b/raspi3/imgs/section1/b2.jpg similarity index 100% rename from raspi3/ja/imgs/section1/b2.jpg rename to raspi3/imgs/section1/b2.jpg diff --git a/raspi3/ja/imgs/section1/b2.png b/raspi3/imgs/section1/b2.png similarity index 100% rename from raspi3/ja/imgs/section1/b2.png rename to raspi3/imgs/section1/b2.png diff --git a/raspi3/ja/imgs/section1/chibigear_1.jpg b/raspi3/imgs/section1/chibigear_1.jpg similarity index 100% rename from raspi3/ja/imgs/section1/chibigear_1.jpg rename to raspi3/imgs/section1/chibigear_1.jpg diff --git a/raspi3/ja/imgs/section1/chibigear_2.jpg b/raspi3/imgs/section1/chibigear_2.jpg similarity index 100% rename from raspi3/ja/imgs/section1/chibigear_2.jpg rename to raspi3/imgs/section1/chibigear_2.jpg diff --git a/raspi3/ja/imgs/section1/dcfan.png b/raspi3/imgs/section1/dcfan.png similarity index 100% rename from raspi3/ja/imgs/section1/dcfan.png rename to raspi3/imgs/section1/dcfan.png diff --git a/raspi3/ja/imgs/section1/k.png b/raspi3/imgs/section1/k.png similarity index 100% rename from raspi3/ja/imgs/section1/k.png rename to raspi3/imgs/section1/k.png diff --git a/raspi3/ja/imgs/section1/mosfet.png b/raspi3/imgs/section1/mosfet.png similarity index 100% rename from raspi3/ja/imgs/section1/mosfet.png rename to raspi3/imgs/section1/mosfet.png diff --git a/raspi3/ja/imgs/section1/parts.jpg b/raspi3/imgs/section1/parts.jpg similarity index 100% rename from raspi3/ja/imgs/section1/parts.jpg rename to raspi3/imgs/section1/parts.jpg diff --git a/raspi3/ja/imgs/section1/readme.md b/raspi3/imgs/section1/readme.md similarity index 100% rename from raspi3/ja/imgs/section1/readme.md rename to raspi3/imgs/section1/readme.md diff --git a/raspi3/ja/imgs/section1/s.png b/raspi3/imgs/section1/s.png similarity index 100% rename from raspi3/ja/imgs/section1/s.png rename to raspi3/imgs/section1/s.png diff --git a/raspi3/ja/imgs/section1/s2.png b/raspi3/imgs/section1/s2.png similarity index 100% rename from raspi3/ja/imgs/section1/s2.png rename to raspi3/imgs/section1/s2.png diff --git a/raspi3/ja/imgs/section1/t.jpg b/raspi3/imgs/section1/t.jpg similarity index 100% rename from raspi3/ja/imgs/section1/t.jpg rename to raspi3/imgs/section1/t.jpg diff --git a/raspi3/ja/imgs/section1/t.png b/raspi3/imgs/section1/t.png similarity index 100% rename from raspi3/ja/imgs/section1/t.png rename to raspi3/imgs/section1/t.png diff --git a/raspi3/ja/imgs/section1/tactswitch.fzz b/raspi3/imgs/section1/tactswitch.fzz similarity index 100% rename from raspi3/ja/imgs/section1/tactswitch.fzz rename to raspi3/imgs/section1/tactswitch.fzz diff --git a/raspi3/ja/imgs/section1/tactswitch.png b/raspi3/imgs/section1/tactswitch.png similarity index 100% rename from raspi3/ja/imgs/section1/tactswitch.png rename to raspi3/imgs/section1/tactswitch.png diff --git a/raspi3/ja/imgs/section2/ADT7410.png b/raspi3/imgs/section2/ADT7410.png similarity index 100% rename from raspi3/ja/imgs/section2/ADT7410.png rename to raspi3/imgs/section2/ADT7410.png diff --git a/raspi3/ja/imgs/section2/ADT7410OFF.png b/raspi3/imgs/section2/ADT7410OFF.png similarity index 100% rename from raspi3/ja/imgs/section2/ADT7410OFF.png rename to raspi3/imgs/section2/ADT7410OFF.png diff --git a/raspi3/ja/imgs/section2/I2C.png b/raspi3/imgs/section2/I2C.png similarity index 100% rename from raspi3/ja/imgs/section2/I2C.png rename to raspi3/imgs/section2/I2C.png diff --git a/raspi3/ja/imgs/section2/I2CBusAddressOptions.png b/raspi3/imgs/section2/I2CBusAddressOptions.png similarity index 100% rename from raspi3/ja/imgs/section2/I2CBusAddressOptions.png rename to raspi3/imgs/section2/I2CBusAddressOptions.png diff --git a/raspi3/ja/imgs/section2/browser.png b/raspi3/imgs/section2/browser.png similarity index 100% rename from raspi3/ja/imgs/section2/browser.png rename to raspi3/imgs/section2/browser.png diff --git a/raspi3/ja/imgs/section2/i2c-bus.png b/raspi3/imgs/section2/i2c-bus.png similarity index 100% rename from raspi3/ja/imgs/section2/i2c-bus.png rename to raspi3/imgs/section2/i2c-bus.png diff --git a/raspi3/ja/imgs/section2/i2c-bus2.png b/raspi3/imgs/section2/i2c-bus2.png similarity index 100% rename from raspi3/ja/imgs/section2/i2c-bus2.png rename to raspi3/imgs/section2/i2c-bus2.png diff --git a/raspi3/ja/imgs/section2/parts.jpg b/raspi3/imgs/section2/parts.jpg similarity index 100% rename from raspi3/ja/imgs/section2/parts.jpg rename to raspi3/imgs/section2/parts.jpg diff --git a/raspi3/ja/imgs/section2/parts.png b/raspi3/imgs/section2/parts.png similarity index 100% rename from raspi3/ja/imgs/section2/parts.png rename to raspi3/imgs/section2/parts.png diff --git a/raspi3/ja/imgs/section2/readme.md b/raspi3/imgs/section2/readme.md similarity index 100% rename from raspi3/ja/imgs/section2/readme.md rename to raspi3/imgs/section2/readme.md diff --git a/raspi3/ja/imgs/section2/schematic.png b/raspi3/imgs/section2/schematic.png similarity index 100% rename from raspi3/ja/imgs/section2/schematic.png rename to raspi3/imgs/section2/schematic.png diff --git a/raspi3/ja/imgs/section2/schematic_S2.fzz b/raspi3/imgs/section2/schematic_S2.fzz similarity index 100% rename from raspi3/ja/imgs/section2/schematic_S2.fzz rename to raspi3/imgs/section2/schematic_S2.fzz diff --git a/raspi3/ja/imgs/section2/schematic_warning.png b/raspi3/imgs/section2/schematic_warning.png similarity index 100% rename from raspi3/ja/imgs/section2/schematic_warning.png rename to raspi3/imgs/section2/schematic_warning.png diff --git a/raspi3/ja/imgs/section2/temperature_real.jpg b/raspi3/imgs/section2/temperature_real.jpg similarity index 100% rename from raspi3/ja/imgs/section2/temperature_real.jpg rename to raspi3/imgs/section2/temperature_real.jpg diff --git a/raspi3/ja/imgs/section3/VL53L0X_comp.jpg b/raspi3/imgs/section3/VL53L0X_comp.jpg similarity index 100% rename from raspi3/ja/imgs/section3/VL53L0X_comp.jpg rename to raspi3/imgs/section3/VL53L0X_comp.jpg diff --git a/raspi3/ja/imgs/section3/h.jpg b/raspi3/imgs/section3/h.jpg similarity index 100% rename from raspi3/ja/imgs/section3/h.jpg rename to raspi3/imgs/section3/h.jpg diff --git a/raspi3/ja/imgs/section3/h.png b/raspi3/imgs/section3/h.png similarity index 100% rename from raspi3/ja/imgs/section3/h.png rename to raspi3/imgs/section3/h.png diff --git a/raspi3/ja/imgs/section3/k.png b/raspi3/imgs/section3/k.png similarity index 100% rename from raspi3/ja/imgs/section3/k.png rename to raspi3/imgs/section3/k.png diff --git a/raspi3/ja/imgs/section3/k2.png b/raspi3/imgs/section3/k2.png similarity index 100% rename from raspi3/ja/imgs/section3/k2.png rename to raspi3/imgs/section3/k2.png diff --git a/raspi3/ja/imgs/section3/k3.jpg b/raspi3/imgs/section3/k3.jpg similarity index 100% rename from raspi3/ja/imgs/section3/k3.jpg rename to raspi3/imgs/section3/k3.jpg diff --git a/raspi3/ja/imgs/section3/k3.png b/raspi3/imgs/section3/k3.png similarity index 100% rename from raspi3/ja/imgs/section3/k3.png rename to raspi3/imgs/section3/k3.png diff --git a/raspi3/ja/imgs/section3/k4.png b/raspi3/imgs/section3/k4.png similarity index 100% rename from raspi3/ja/imgs/section3/k4.png rename to raspi3/imgs/section3/k4.png diff --git a/raspi3/ja/imgs/section3/readme.md b/raspi3/imgs/section3/readme.md similarity index 100% rename from raspi3/ja/imgs/section3/readme.md rename to raspi3/imgs/section3/readme.md diff --git a/raspi3/ja/imgs/section4/parts-1.jpg b/raspi3/imgs/section4/parts-1.jpg similarity index 100% rename from raspi3/ja/imgs/section4/parts-1.jpg rename to raspi3/imgs/section4/parts-1.jpg diff --git a/raspi3/ja/imgs/section4/parts-1.png b/raspi3/imgs/section4/parts-1.png similarity index 100% rename from raspi3/ja/imgs/section4/parts-1.png rename to raspi3/imgs/section4/parts-1.png diff --git a/raspi3/ja/imgs/section4/readme.md b/raspi3/imgs/section4/readme.md similarity index 100% rename from raspi3/ja/imgs/section4/readme.md rename to raspi3/imgs/section4/readme.md diff --git a/raspi3/ja/imgs/section4/schematic.png b/raspi3/imgs/section4/schematic.png similarity index 100% rename from raspi3/ja/imgs/section4/schematic.png rename to raspi3/imgs/section4/schematic.png diff --git a/raspi3/ja/imgs/section5/bledemo1.jpg b/raspi3/imgs/section5/bledemo1.jpg similarity index 100% rename from raspi3/ja/imgs/section5/bledemo1.jpg rename to raspi3/imgs/section5/bledemo1.jpg diff --git a/raspi3/ja/imgs/section5/bledemo2.png b/raspi3/imgs/section5/bledemo2.png similarity index 100% rename from raspi3/ja/imgs/section5/bledemo2.png rename to raspi3/imgs/section5/bledemo2.png diff --git a/raspi3/ja/imgs/section5/bledemo3.png b/raspi3/imgs/section5/bledemo3.png similarity index 100% rename from raspi3/ja/imgs/section5/bledemo3.png rename to raspi3/imgs/section5/bledemo3.png diff --git a/raspi3/ja/imgs/section5/bledemo4.png b/raspi3/imgs/section5/bledemo4.png similarity index 100% rename from raspi3/ja/imgs/section5/bledemo4.png rename to raspi3/imgs/section5/bledemo4.png diff --git a/raspi3/ja/imgs/section5/bledemo5.jpeg b/raspi3/imgs/section5/bledemo5.jpeg similarity index 100% rename from raspi3/ja/imgs/section5/bledemo5.jpeg rename to raspi3/imgs/section5/bledemo5.jpeg diff --git a/raspi3/ja/imgs/section5/blemov.mp4 b/raspi3/imgs/section5/blemov.mp4 similarity index 100% rename from raspi3/ja/imgs/section5/blemov.mp4 rename to raspi3/imgs/section5/blemov.mp4 diff --git a/raspi3/ja/imgs/section5/blemov.png b/raspi3/imgs/section5/blemov.png similarity index 100% rename from raspi3/ja/imgs/section5/blemov.png rename to raspi3/imgs/section5/blemov.png diff --git a/raspi3/ja/imgs/section5/readme.md b/raspi3/imgs/section5/readme.md similarity index 100% rename from raspi3/ja/imgs/section5/readme.md rename to raspi3/imgs/section5/readme.md diff --git a/raspi3/ja/imgs/section6/i1.jpg b/raspi3/imgs/section6/i1.jpg similarity index 100% rename from raspi3/ja/imgs/section6/i1.jpg rename to raspi3/imgs/section6/i1.jpg diff --git a/raspi3/ja/imgs/section6/i2.png b/raspi3/imgs/section6/i2.png similarity index 100% rename from raspi3/ja/imgs/section6/i2.png rename to raspi3/imgs/section6/i2.png diff --git a/raspi3/ja/imgs/section6/i3.png b/raspi3/imgs/section6/i3.png similarity index 100% rename from raspi3/ja/imgs/section6/i3.png rename to raspi3/imgs/section6/i3.png diff --git a/raspi3/ja/imgs/section6/i4.png b/raspi3/imgs/section6/i4.png similarity index 100% rename from raspi3/ja/imgs/section6/i4.png rename to raspi3/imgs/section6/i4.png diff --git a/raspi3/ja/imgs/section6/i5.png b/raspi3/imgs/section6/i5.png similarity index 100% rename from raspi3/ja/imgs/section6/i5.png rename to raspi3/imgs/section6/i5.png diff --git a/raspi3/ja/imgs/section6/i6.png b/raspi3/imgs/section6/i6.png similarity index 100% rename from raspi3/ja/imgs/section6/i6.png rename to raspi3/imgs/section6/i6.png diff --git a/raspi3/ja/imgs/section6/i7.png b/raspi3/imgs/section6/i7.png similarity index 100% rename from raspi3/ja/imgs/section6/i7.png rename to raspi3/imgs/section6/i7.png diff --git a/raspi3/ja/imgs/section6/readme.md b/raspi3/imgs/section6/readme.md similarity index 100% rename from raspi3/ja/imgs/section6/readme.md rename to raspi3/imgs/section6/readme.md diff --git a/raspi3/ja/imgs/starterkit/starterkit.jpg b/raspi3/imgs/starterkit/starterkit.jpg similarity index 100% rename from raspi3/ja/imgs/starterkit/starterkit.jpg rename to raspi3/imgs/starterkit/starterkit.jpg diff --git a/raspi3/ja/imgs/starterkit/starterset.jpg b/raspi3/imgs/starterkit/starterset.jpg similarity index 100% rename from raspi3/ja/imgs/starterkit/starterset.jpg rename to raspi3/imgs/starterkit/starterset.jpg diff --git a/raspi3/ja/readme.md b/raspi3/ja/readme.md deleted file mode 100644 index 66bc28ec..00000000 --- a/raspi3/ja/readme.md +++ /dev/null @@ -1,98 +0,0 @@ -## CHIRIMEN for Raspberry Pi3 チュートリアル - -CHIRIMEN for Raspberry Pi 3を用いた IoT システムプロトタイピングスキル習得のためのチュートリアル資料です。 - -JavaScript プログラミング未経験者は、ページ下部で紹介している資料・サイトも参照しつつご覧ください。 - -## Hello Real World -短時間でさっと CHIRIMEN を体験するときにはこちらをご覧ください。 - -- [Hello Real World](hellorealworld.md) - -LED と温度センサーを使ってみる最小限のお試しページです。より詳しくは以下のチュートリアルをご覧ください。 - -## 基礎編 -まずはシンプルな GPIO 入出力や I2C センサーの操作方法を学びましょう。 - -- [0. L チカしてみよう (初めての GPIO)](section0.md) - - [WebGPIO API](http://browserobo.github.io/WebGPIO/) を使って定期的に LED を点滅するサンプルを動かしてみます。 -- [1. GPIO の使い方](section1.md) - - マウスクリックで操作するブラウザ画面のボタンと物理スイッチ (タクトスイッチ) の両方で LED やモーターを制御するサンプルを通じて GPIO の基本を学びます。 -- [2. センサーを使ってみよう (初めての I2C)](section2.md) - - 温度センサーの値をドライバーを使う場合と [WebGPIO API](http://browserobo.github.io/WebI2C/) を直接操作する場合の 2 パターンで読み取ることで、I2C デバイス操作の基本を学びます。 - -## 応用編 -いろいろな I2C デバイスを繋いだり組み合わせたりすることで IoT プロトタイピングを体験しましょう。 - -- [3. I2C の使い方](section3.md) - - いろいろな I2C デバイスを接続したり、複数の I2C デバイスの同時操作について学びます。 -- [4. GPIO/I2C のまとめ](section4.md) - - これまでの総括として GPIO と I2C の両方を組み合わせて動かしてみます。 - -ここまでできたら Example 集を見ていろいろなデバイスを試したり自分で好きなものを作ってみましょう。 - -## 発展編 -ここまでの例では飽き足らない人のための発展的な使い方を紹介します。興味のあるものがあればお試しください。 -**注意: 学校や講習会などで参加者全員で学習する場合は応用編までで十分です。** - -- 5. WebBluetooth の使い方 - - CHIRIMEN for Raspberry Pi 3 環境で Web Bluetooth API を使って制御するチュートリアルです。 - - [PLAYBULB制御](section5.md) - - Web I2C API や Web Audio API と組み合わせて PLAYBULB (Bluetooth 接続の LED 電球) を制御します。 - - [micro:bitを使う](http://chirimen.org/webGPIO-etc-on-microbit-via-webBluetooth/) - - 専用ライブラリ使い、micro:bitに搭載されたデバイスやインターフェースを利用します。 - - micro:bit 内蔵デバイス - - 3 軸加速度センサー、3 軸磁気センサー、温度センサー、タクトスイッチ 2個、5x5 マトリクス LED - - 外部デバイス (GPIO ポート) - - micro:bit 用の WebGPIO API ライブラリを使えば、Raspberry Pi3 と同様に操作できます。 -- [6. ステッピングモーターを制御する](section6.md) - - CHIRIMEN for Raspberry Pi 3 と Arduino を組み合わせてステップピングモーターを制御します。I2C 接続した Arduino を利用することで μ 秒単位でモータードライバの制御を行います。 - -## 対応デバイスと Example 集 -CHIRIMEN for Raspberry Pi 3 対応デバイスのドライバ・回路図・サンプルコードをセットにした Example 集を用意しています。 - -- [Basic GPIO Example](http://chirimen.org/chirimen-raspi3/gc/top/examples/#gpioExamples) -- [Basic I2C Example](http://chirimen.org/chirimen-raspi3/gc/top/examples/#i2cExamples) -- [Advanced Example](http://chirimen.org/chirimen-raspi3/gc/top/examples/#advanced) - -Basic GPIO/I2C Examle のデバイスは CHIRIMEN Raspi3 の OS イメージ公開前に動作検証をしている CHIRIMEN Certified デバイスです。 -Advanced Example は個人レベルで動作確認して追加されている contrib デバイスです。いずれも元のソースコードは [こちら](https://github.com/chirimen-oh/chirimen-raspi3/tree/master/gc) に収録されています。 - -## Appendix, Tips, FAQ, Links etc... -JavaScript 未経験者や非同期処理に慣れていない方向けの解説はこちらをご覧ください: - -- [JavaScript 1 Day 講習 (PDF)](https://webiotmakers.github.io/static/docs/2017/maebashi-js.pdf) - - 初めてプログラミングする人に 1 日で JavaScript を教えるときにちょうど良いボリューム・内容の資料です -- [JavaScript Primer - ECMAScript 2019時代のJavaScript入門書](https://jsprimer.net/) - - 最新言語仕様も考慮した本格的な JavaScript 入門書です - - 開発ツールなどについても [付録: 参考リンク集](https://jsprimer.net/appendix/links/) が参考になります -- [非同期処理 (async await版)](appendix0.md) - - ハード制御で必ず必要だが引っかかる人が多い非同期処理についての解説です - - 非同期処理についてより詳しくは [JS Primer の非同期処理説明ページ](https://jsprimer.net/basic/async/) が参考になります - -良くある質問、Tips やテクニック、デバッグとトラブルシューティングについてはこちらをご覧ください: - -- [良くある質問](faq.md) -- [Tips・テクニック集](tips.md) -- [デバッグ・トラブルシューティング](debug.md) -- [講師向けページ](teacher.md) - -## 以前のチュートリアル -本チュートリアルは CHIRIMEN コミュニティで日々更新していますが、使用機材や手順を変更することもあります。お手持ちの機材が古い場合や、以前学習したときのものを参照したい場合など、必要に応じてこちらのアーカイブをご覧ください。 - -- [2018 年度のスターターキットを利用するチュートリアル](https://webiot-2018--tutorial-chirimen-org.netlify.com/raspi3/ja/) - - DC Fan を含む、初期スターターキットを使うチュートリアルです。 - - [Web x IoT Makers Challenge 2018-19](https://webiotmakers.github.io/) で採用されていたバージョンです。 -- [オリジナルチュートリアル (Qiita 版)](deprecated.md) - - 本チュートリアルサイトの元となる、CHIRIMEN コミュニティメンバーが当初 Qiita などで執筆していた記事のリンク集です。 - -
- - - ## Latest Version / 最新版 - - Latest version of this document is hosted on https://tutorial.chirimen.org/raspi3/ja/ - - このサイトの最新オンライン版は https://tutorial.chirimen.org/raspi3/ja/ でご覧頂けます -
- diff --git a/raspi3/en/readme.md b/raspi3/readme-en.md similarity index 96% rename from raspi3/en/readme.md rename to raspi3/readme-en.md index fb3aed3b..5e916f09 100644 --- a/raspi3/en/readme.md +++ b/raspi3/readme-en.md @@ -1,3 +1,8 @@ +--- +lang: en +permalink: /raspi3/ +--- + # Index page of tutorials for CHIRIMEN for Raspberry Pi3 We expect the contribution of translation work. diff --git a/raspi3/readme.md b/raspi3/readme.md index 4eb8d8bf..102a44df 100644 --- a/raspi3/readme.md +++ b/raspi3/readme.md @@ -1,5 +1,103 @@ -You can find tutorials for CHIRIMEN for Raspberry Pi 3 in this directory +--- +lang: ja +permalink: /raspi3/ +--- + +## CHIRIMEN for Raspberry Pi3 チュートリアル + +CHIRIMEN for Raspberry Pi 3を用いた IoT システムプロトタイピングスキル習得のためのチュートリアル資料です。 + +JavaScript プログラミング未経験者は、ページ下部で紹介している資料・サイトも参照しつつご覧ください。 + +## Hello Real World +短時間でさっと CHIRIMEN を体験するときにはこちらをご覧ください。 + +- [Hello Real World](hellorealworld.md) + +LED と温度センサーを使ってみる最小限のお試しページです。より詳しくは以下のチュートリアルをご覧ください。 + +## 基礎編 +まずはシンプルな GPIO 入出力や I2C センサーの操作方法を学びましょう。 + +- [0. L チカしてみよう (初めての GPIO)](section0.md) + - [WebGPIO API](http://browserobo.github.io/WebGPIO/) を使って定期的に LED を点滅するサンプルを動かしてみます。 +- [1. GPIO の使い方](section1.md) + - マウスクリックで操作するブラウザ画面のボタンと物理スイッチ (タクトスイッチ) の両方で LED やモーターを制御するサンプルを通じて GPIO の基本を学びます。 +- [2. センサーを使ってみよう (初めての I2C)](section2.md) + - 温度センサーの値をドライバーを使う場合と [WebGPIO API](http://browserobo.github.io/WebI2C/) を直接操作する場合の 2 パターンで読み取ることで、I2C デバイス操作の基本を学びます。 + +## 応用編 +いろいろな I2C デバイスを繋いだり組み合わせたりすることで IoT プロトタイピングを体験しましょう。 + +- [3. I2C の使い方](section3.md) + - いろいろな I2C デバイスを接続したり、複数の I2C デバイスの同時操作について学びます。 +- [4. GPIO/I2C のまとめ](section4.md) + - これまでの総括として GPIO と I2C の両方を組み合わせて動かしてみます。 + +ここまでできたら Example 集を見ていろいろなデバイスを試したり自分で好きなものを作ってみましょう。 + +## 発展編 +ここまでの例では飽き足らない人のための発展的な使い方を紹介します。興味のあるものがあればお試しください。 +**注意: 学校や講習会などで参加者全員で学習する場合は応用編までで十分です。** + +- 5. WebBluetooth の使い方 + - CHIRIMEN for Raspberry Pi 3 環境で Web Bluetooth API を使って制御するチュートリアルです。 + - [PLAYBULB制御](section5.md) + - Web I2C API や Web Audio API と組み合わせて PLAYBULB (Bluetooth 接続の LED 電球) を制御します。 + - [micro:bitを使う](http://chirimen.org/webGPIO-etc-on-microbit-via-webBluetooth/) + - 専用ライブラリ使い、micro:bitに搭載されたデバイスやインターフェースを利用します。 + - micro:bit 内蔵デバイス + - 3 軸加速度センサー、3 軸磁気センサー、温度センサー、タクトスイッチ 2個、5x5 マトリクス LED + - 外部デバイス (GPIO ポート) + - micro:bit 用の WebGPIO API ライブラリを使えば、Raspberry Pi3 と同様に操作できます。 +- [6. ステッピングモーターを制御する](section6.md) + - CHIRIMEN for Raspberry Pi 3 と Arduino を組み合わせてステップピングモーターを制御します。I2C 接続した Arduino を利用することで μ 秒単位でモータードライバの制御を行います。 + +## 対応デバイスと Example 集 +CHIRIMEN for Raspberry Pi 3 対応デバイスのドライバ・回路図・サンプルコードをセットにした Example 集を用意しています。 + +- [Basic GPIO Example](http://chirimen.org/chirimen-raspi3/gc/top/examples/#gpioExamples) +- [Basic I2C Example](http://chirimen.org/chirimen-raspi3/gc/top/examples/#i2cExamples) +- [Advanced Example](http://chirimen.org/chirimen-raspi3/gc/top/examples/#advanced) + +Basic GPIO/I2C Examle のデバイスは CHIRIMEN Raspi3 の OS イメージ公開前に動作検証をしている CHIRIMEN Certified デバイスです。 +Advanced Example は個人レベルで動作確認して追加されている contrib デバイスです。いずれも元のソースコードは [こちら](https://github.com/chirimen-oh/chirimen-raspi3/tree/master/gc) に収録されています。 + +## Appendix, Tips, FAQ, Links etc... +JavaScript 未経験者や非同期処理に慣れていない方向けの解説はこちらをご覧ください: + +- [JavaScript 1 Day 講習 (PDF)](https://webiotmakers.github.io/static/docs/2017/maebashi-js.pdf) + - 初めてプログラミングする人に 1 日で JavaScript を教えるときにちょうど良いボリューム・内容の資料です +- [JavaScript Primer - ECMAScript 2019時代のJavaScript入門書](https://jsprimer.net/) + - 最新言語仕様も考慮した本格的な JavaScript 入門書です + - 開発ツールなどについても [付録: 参考リンク集](https://jsprimer.net/appendix/links/) が参考になります +- [非同期処理 (async await版)](appendix0.md) + - ハード制御で必ず必要だが引っかかる人が多い非同期処理についての解説です + - 非同期処理についてより詳しくは [JS Primer の非同期処理説明ページ](https://jsprimer.net/basic/async/) が参考になります + +良くある質問、Tips やテクニック、デバッグとトラブルシューティングについてはこちらをご覧ください: + +- [良くある質問](faq.md) +- [Tips・テクニック集](tips.md) +- [デバッグ・トラブルシューティング](debug.md) +- [講師向けページ](teacher.md) + +## 以前のチュートリアル +本チュートリアルは CHIRIMEN コミュニティで日々更新していますが、使用機材や手順を変更することもあります。お手持ちの機材が古い場合や、以前学習したときのものを参照したい場合など、必要に応じてこちらのアーカイブをご覧ください。 + +- [2018 年度のスターターキットを利用するチュートリアル](https://webiot-2018--tutorial-chirimen-org.netlify.com/raspi3/ja/) + - DC Fan を含む、初期スターターキットを使うチュートリアルです。 + - [Web x IoT Makers Challenge 2018-19](https://webiotmakers.github.io/) で採用されていたバージョンです。 +- [オリジナルチュートリアル (Qiita 版)](deprecated.md) + - 本チュートリアルサイトの元となる、CHIRIMEN コミュニティメンバーが当初 Qiita などで執筆していた記事のリンク集です。 + +
+ + + ## Latest Version / 最新版 + + Latest version of this document is hosted on https://tutorial.chirimen.org/raspi3/ja/ + + このサイトの最新オンライン版は https://tutorial.chirimen.org/raspi3/ja/ でご覧頂けます +
-このディレクトリは、CHIRIMEN for Raspberry Pi 3 用のチュートリアルが格納されています。 -* [ENGLISH](EN) -* [日本語](JA) diff --git a/raspi3/ja/sdcard.md b/raspi3/sdcard.md similarity index 100% rename from raspi3/ja/sdcard.md rename to raspi3/sdcard.md diff --git a/raspi3/en/section0.md b/raspi3/section0-en.md similarity index 99% rename from raspi3/en/section0.md rename to raspi3/section0-en.md index c6612607..f4e1bb76 100644 --- a/raspi3/en/section0.md +++ b/raspi3/section0-en.md @@ -1,3 +1,9 @@ +--- +layout: tutorial +lang: en +permalink: /raspi3/section0 +--- + # Hello World # 1. Today’s Objective diff --git a/raspi3/ja/section0.md b/raspi3/section0.md similarity index 99% rename from raspi3/ja/section0.md rename to raspi3/section0.md index 014114ab..b1675acf 100644 --- a/raspi3/ja/section0.md +++ b/raspi3/section0.md @@ -1,5 +1,7 @@ --- layout: tutorial +lang: ja +permalink: /raspi3/section0 --- # L チカしてみよう (初めての GPIO) diff --git a/raspi3/ja/section1.md b/raspi3/section1.md similarity index 100% rename from raspi3/ja/section1.md rename to raspi3/section1.md diff --git a/raspi3/ja/section2.md b/raspi3/section2.md similarity index 100% rename from raspi3/ja/section2.md rename to raspi3/section2.md diff --git a/raspi3/ja/section3.md b/raspi3/section3.md similarity index 100% rename from raspi3/ja/section3.md rename to raspi3/section3.md diff --git a/raspi3/ja/section4.md b/raspi3/section4.md similarity index 100% rename from raspi3/ja/section4.md rename to raspi3/section4.md diff --git a/raspi3/ja/section5.md b/raspi3/section5.md similarity index 100% rename from raspi3/ja/section5.md rename to raspi3/section5.md diff --git a/raspi3/ja/section6.md b/raspi3/section6.md similarity index 100% rename from raspi3/ja/section6.md rename to raspi3/section6.md diff --git a/raspi3/ja/teacher.md b/raspi3/teacher.md similarity index 100% rename from raspi3/ja/teacher.md rename to raspi3/teacher.md diff --git a/raspi3/ja/tips.md b/raspi3/tips.md similarity index 100% rename from raspi3/ja/tips.md rename to raspi3/tips.md