2015-02-24 18:09:41 +08:00
|
|
|
#Pinout 2
|
|
|
|
|
2015-03-22 07:04:31 +08:00
|
|
|
Pinout 2 is the successor to the popular Pi pinout website http://pi.gadgetoid.com/pinout
|
2015-02-24 18:09:41 +08:00
|
|
|
|
2015-03-26 07:13:28 +08:00
|
|
|
To support translation efforts, and allow people to build tools with the data in this repository, Pinout 2 is
|
|
|
|
provided under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.
|
|
|
|
|
2015-02-24 18:09:41 +08:00
|
|
|
This project aims to build a consistent workflow behind the Pinout front-end, and invite board manufacturers
|
|
|
|
to produce their own "overlay" files which describe which pins their Pi add-ons use.
|
|
|
|
|
|
|
|
I hope that by making this project open and extensible I will invite not only contributions of board pinouts,
|
2015-03-26 07:13:28 +08:00
|
|
|
but translations too.
|
|
|
|
|
|
|
|
I'm also looking for feedback about the structure of the JSON files, what information needs to be contained in
|
|
|
|
them, how they can better support translation and any other suggestions you might have.
|
2015-02-24 18:09:41 +08:00
|
|
|
|
2015-03-22 07:04:31 +08:00
|
|
|
#Contributing
|
|
|
|
|
2015-11-09 05:35:58 +08:00
|
|
|
If you have a board you'd like to contribute, raise an issue and we'll consider it!
|
2015-03-22 07:04:31 +08:00
|
|
|
|
2015-11-09 05:35:58 +08:00
|
|
|
#Translating
|
2015-03-22 07:04:31 +08:00
|
|
|
|
2015-11-09 05:35:58 +08:00
|
|
|
The contents of this GitHub repository are used to build http://pinout.xyz and its translated subdomains.
|
2015-03-22 07:04:31 +08:00
|
|
|
|
2015-11-09 05:35:58 +08:00
|
|
|
Current known contributors are:
|
2015-02-24 18:09:41 +08:00
|
|
|
|
2015-11-15 04:32:46 +08:00
|
|
|
* de - @rdmueller and @KojoePi
|
|
|
|
* es - @ResonantWave
|
|
|
|
* fr - @RogueM
|
|
|
|
* it - @LizardM4
|
2015-12-04 01:31:15 +08:00
|
|
|
* pt - @Maslor
|
2015-11-15 04:32:46 +08:00
|
|
|
* tr - @Ardakilic
|
2015-02-24 18:09:41 +08:00
|
|
|
|
2015-11-15 04:32:46 +08:00
|
|
|
If you would like to provide support for a language not yet in the repository you should start by duplicating the `src/en` directory to the
|
2015-11-14 07:16:37 +08:00
|
|
|
appropriate culture. For example if you want to create a German translation you would create the folder `src/de`.
|
2015-02-24 18:09:41 +08:00
|
|
|
|
2015-11-14 07:16:37 +08:00
|
|
|
There are no plans to support cultures, so you can't have `src/fr-CA` ( sorry! ).
|
2015-02-24 18:09:41 +08:00
|
|
|
|
2015-11-09 05:35:58 +08:00
|
|
|
Once you've made your translation, build and preview it with, for example:
|
|
|
|
|
|
|
|
```bash
|
2015-11-14 07:16:37 +08:00
|
|
|
make serve LANG=de
|
2015-11-09 05:35:58 +08:00
|
|
|
```
|
|
|
|
|
|
|
|
And then open: http://127.0.0.1:5000 in your browser.
|
2015-02-24 18:09:41 +08:00
|
|
|
|
2015-11-09 05:35:58 +08:00
|
|
|
Please do not attempt to translate the `/resources` folder, this is shared between sites on the server and should be generic.
|
2015-02-24 18:09:41 +08:00
|
|
|
|
2015-11-09 05:35:58 +08:00
|
|
|
Feel free to modify the template with links relevent to your country, and your Twitter handle but don't fiddle with the structure!
|
2015-02-24 18:09:41 +08:00
|
|
|
|
2015-11-09 05:35:58 +08:00
|
|
|
Submit your finished translation as a pull request and I'll get it live on pinout.xyz.
|
|
|
|
|
|
|
|
#Roadmap
|
|
|
|
|
|
|
|
* Redesign UI to support browsing a wider variety of boards and viewing their pinouts ( partially done with drop down )
|
|
|
|
* Replace top tabs with some sort of search functionality or easy categorised UI for finding boards
|
|
|
|
* Allow for slightly longer descriptions of Pin functions ( baloons? ), current width is very restrictive
|
2015-02-24 18:09:41 +08:00
|
|
|
* Does X board work with Y board
|
2015-11-09 05:35:58 +08:00
|
|
|
* What extra functions does this pin have ( mostly done with ALT functions tables, but needs descriptions )
|
2015-11-14 07:16:37 +08:00
|
|
|
* Tool to convert WiringPi to GPIO to BCM and back
|