Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Documentation - Docusaurus port #586

Merged
Merged
Show file tree
Hide file tree
Changes from 115 commits
Commits
Show all changes
116 commits
Select commit Hold shift + click to select a range
f313ad2
Add expanding add-on sidebar element
InfraredAces Oct 5, 2023
d13ff2c
Breakout Add-ons into separate pages
InfraredAces Oct 7, 2023
18e160e
Update markdown links to add-ons
InfraredAces Oct 7, 2023
c2caf81
Close tags in README
InfraredAces Oct 7, 2023
ad5399c
Correct minor typos in README
InfraredAces Oct 7, 2023
43b5c1c
Create Initial Docusaurus documentation
InfraredAces Oct 8, 2023
11d5e99
Create Dev Section in navbar and devSidebar
InfraredAces Oct 8, 2023
73133f9
Bump some dependencies
Pelsin Oct 8, 2023
7d5715f
Add macro documentation
InfraredAces Oct 8, 2023
cc04ee9
Add local search functionality
Pelsin Oct 8, 2023
b5db875
Auto prettier and remove non working links(should be added later)
Pelsin Oct 8, 2023
cb13e08
Merge branch 'documentation-docusaurus-port' into documentation-docus…
InfraredAces Oct 8, 2023
ab90c43
Merge pull request #1 from Pelsin/documentation-docusaurus-port
InfraredAces Oct 8, 2023
ea3d2ed
Separate Web Configurator in Navbar and sidebar
InfraredAces Oct 8, 2023
d85ef26
Start iterating over config to show in downloads
Pelsin Oct 8, 2023
f0a6908
Change docsify alert to docusaurus admonitions
InfraredAces Oct 9, 2023
dbb18f4
Improve styling and description for download info boxes
Pelsin Oct 9, 2023
be9af94
Merge branch 'documentation-docusaurus-port' into downloads
InfraredAces Oct 11, 2023
29cbcbb
Merge pull request #2 from Pelsin/downloads
InfraredAces Oct 11, 2023
7e76be9
Update Download page location
InfraredAces Oct 11, 2023
7aa5aa6
Add version dropdown
InfraredAces Oct 13, 2023
e37a3cb
Add configs to downloads page
InfraredAces Oct 13, 2023
1402e15
Format Download Links
InfraredAces Oct 13, 2023
581c675
Add PicoAnn description
InfraredAces Oct 13, 2023
12c2e7d
Prettier on sidebar
Pelsin Oct 13, 2023
0df6e31
Create a typed component for link icons
Pelsin Oct 13, 2023
8b793a2
Extract board config for easier update in the future and use the type…
Pelsin Oct 13, 2023
f9ebf2c
Add Liatris asset
InfraredAces Oct 14, 2023
50ceb3d
Format and add content to downloads-page
InfraredAces Oct 14, 2023
a36c465
Update microcontroller download details
InfraredAces Oct 14, 2023
d7d08e3
Update front matter and links
InfraredAces Oct 14, 2023
cae19e0
Update Sidebar contents
InfraredAces Oct 14, 2023
f884579
Add front matter and update links
InfraredAces Oct 14, 2023
65298c8
Merge branch 'documentation-docusaurus-port' into download-links
InfraredAces Oct 14, 2023
2e5813f
Merge pull request #3 from Pelsin/download-links
InfraredAces Oct 14, 2023
2054c28
Update OfficialDevices on Downloads
InfraredAces Oct 14, 2023
1b25f54
Add release version automatically to download link
InfraredAces Oct 14, 2023
5144bd1
Remove static releaseVersion
InfraredAces Oct 14, 2023
4117488
Create a custom hooks for fetching github info
Pelsin Oct 14, 2023
316f795
Merge branch 'documentation-docusaurus-port' into download-links
InfraredAces Oct 14, 2023
a04ece9
Fix OfficialDevices in downloads page
InfraredAces Oct 14, 2023
28d80b3
Merge pull request #3 from InfraredAces/pelsin-download-links-officia…
Pelsin Oct 14, 2023
2afeb00
Merge pull request #4 from Pelsin/download-links
InfraredAces Oct 14, 2023
7526fff
Update links
InfraredAces Oct 15, 2023
a67c82b
Add Label Selector to documents
InfraredAces Oct 15, 2023
5222e28
Add css for label selector
InfraredAces Oct 15, 2023
0d7ccf2
Add check for webpage check and style to selector
InfraredAces Oct 15, 2023
f298442
Update .gitignore
InfraredAces Oct 15, 2023
92e8f66
Merge pull request #7 from InfraredAces/docusaurus-label-selector
InfraredAces Oct 15, 2023
66961b4
Update Label Selector
InfraredAces Oct 15, 2023
c07d622
Update check for Pinout Link
InfraredAces Oct 15, 2023
419d27c
Add color mode config
InfraredAces Oct 15, 2023
1d98381
Add window and localStorage check
InfraredAces Oct 15, 2023
a5f90bc
Hotkey correction
InfraredAces Oct 15, 2023
cf17399
Update hotkeys rgb-led
InfraredAces Oct 15, 2023
a240417
Added global state hook for select label
Pelsin Oct 16, 2023
478ba8f
Merge pull request #8 from Pelsin/documentation-docusaurus-port
InfraredAces Oct 16, 2023
b9b5bb3
Update RGBLED input selector
InfraredAces Oct 16, 2023
53b6161
Add expanding add-on sidebar element
InfraredAces Oct 5, 2023
5664ef3
Create Initial Docusaurus documentation
InfraredAces Oct 8, 2023
fe795e3
Create Dev Section in navbar and devSidebar
InfraredAces Oct 8, 2023
c39880c
Bump some dependencies
Pelsin Oct 8, 2023
9c85965
Add local search functionality
Pelsin Oct 8, 2023
0615ff2
Auto prettier and remove non working links(should be added later)
Pelsin Oct 8, 2023
de14efb
Add macro documentation
InfraredAces Oct 8, 2023
024b9da
Start iterating over config to show in downloads
Pelsin Oct 8, 2023
fc180a2
Improve styling and description for download info boxes
Pelsin Oct 9, 2023
c8e17ee
Separate Web Configurator in Navbar and sidebar
InfraredAces Oct 8, 2023
feb0666
Change docsify alert to docusaurus admonitions
InfraredAces Oct 9, 2023
c93b22a
Update Download page location
InfraredAces Oct 11, 2023
912df6a
Add version dropdown
InfraredAces Oct 13, 2023
bf12010
Add configs to downloads page
InfraredAces Oct 13, 2023
b9dc540
Prettier on sidebar
Pelsin Oct 13, 2023
e93d80c
Create a typed component for link icons
Pelsin Oct 13, 2023
9235df9
Extract board config for easier update in the future and use the type…
Pelsin Oct 13, 2023
6339d99
Add Liatris asset
InfraredAces Oct 14, 2023
217e1fc
Add front matter and update links
InfraredAces Oct 14, 2023
ca77e04
Create a custom hooks for fetching github info
Pelsin Oct 14, 2023
4f2b1d7
Update OfficialDevices on Downloads
InfraredAces Oct 14, 2023
1943e04
Add Label Selector to documents
InfraredAces Oct 15, 2023
ab339f8
Update Label Selector
InfraredAces Oct 15, 2023
afd7f67
Update .gitignore
InfraredAces Oct 15, 2023
a038db2
Update check for Pinout Link
InfraredAces Oct 15, 2023
d3904a7
Added global state hook for select label
Pelsin Oct 16, 2023
0ede8a3
Merge branch 'documentation-docusaurus-port' of https://github.com/In…
InfraredAces Oct 16, 2023
c16464e
Add local storage persistence for selected label
Pelsin Oct 16, 2023
46bc4a6
Update documents to current latest documents
InfraredAces Oct 16, 2023
47cbdff
Correct minor typos
InfraredAces Oct 16, 2023
bff0241
Update broken links
InfraredAces Oct 16, 2023
15d19ba
update main gitignore
InfraredAces Oct 18, 2023
8e698b5
Merge pull request #9 from Pelsin/documentation-docusaurus-port
InfraredAces Oct 19, 2023
03f229a
Add deploy and test-deploy actions
InfraredAces Oct 19, 2023
7d61bb3
Merge branch 'main' of https://github.com/OpenStickCommunity/GP2040-C…
InfraredAces Oct 19, 2023
6925c93
Delete extraneous Macro page
InfraredAces Oct 19, 2023
6e675c0
Merge branch 'main' of https://github.com/OpenStickCommunity/GP2040-C…
InfraredAces Oct 19, 2023
b9f3d52
Update Tilt Input Add-on Image
InfraredAces Oct 19, 2023
273e7c7
Update announcement banner
InfraredAces Oct 23, 2023
dca39ea
Merge branch 'main' of https://github.com/OpenStickCommunity/GP2040-C…
InfraredAces Oct 23, 2023
0d8c7dc
Minor page corrections
InfraredAces Oct 23, 2023
b98893e
Updated info for the Reflex Encode boards
TheTrainGoes Oct 24, 2023
b8fe4c5
Update README.md
TheTrainGoes Oct 24, 2023
fb8f81b
Merge branch '20231023-Reflec-boar-updates' of https://github.com/Ope…
InfraredAces Oct 24, 2023
4365bf5
Update Board Configs
InfraredAces Oct 24, 2023
8332d31
Update board config for Reflex Encode changes
InfraredAces Oct 24, 2023
93fe901
Add Documentation for Documentation
InfraredAces Oct 24, 2023
ae6a017
Add versioned documents for v0.7.5
InfraredAces Oct 24, 2023
e836e68
Merge branch 'main' of https://github.com/OpenStickCommunity/GP2040-C…
InfraredAces Oct 24, 2023
f46787d
Remove Documentation Versioning
InfraredAces Oct 24, 2023
ac6152c
Add Downloads & Preview Documentation
InfraredAces Oct 24, 2023
f09f837
Update for docs to site name change
InfraredAces Oct 24, 2023
4f239d8
Make requested changes from PR Review
InfraredAces Oct 24, 2023
0408f45
Update md files to mdx for consistency
InfraredAces Oct 26, 2023
32ec012
Merge branch 'main' of https://github.com/OpenStickCommunity/GP2040-C…
InfraredAces Oct 27, 2023
ca319dc
Merge branch 'main' of https://github.com/OpenStickCommunity/GP2040-C…
InfraredAces Nov 1, 2023
ece658c
Update Links in project
InfraredAces Nov 1, 2023
f1a4ec8
Update BoardConfig.h
arntsonl Nov 5, 2023
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/ISSUE_TEMPLATE/feature_request.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ assignees: ''

---

### Have you checked the GP2040-CE documentation [HERE](https://gp2040-ce.info/#/) to confirm this feature doesn't already exist?
### Have you checked the GP2040-CE documentation [HERE](https://gp2040-ce.info/) to confirm this feature doesn't already exist?

Yes/No

Expand Down
2 changes: 1 addition & 1 deletion .github/ISSUE_TEMPLATE/issue---bug-report.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ assignees: ''
Please check the following before posting an issue / bug report.

- [ ] I am running the latest version of the firmware found [HERE](https://github.com/OpenStickCommunity/GP2040-CE/releases)
- [ ] I have checked the documentation [HERE](https://gp2040-ce.info/#/) and found no answer
- [ ] I have checked the documentation [HERE](https://gp2040-ce.info/) and found no answer
- [ ] I checked to make sure that this issue has not already been filed [HERE](https://github.com/OpenStickCommunity/GP2040-CE/issues)
- [ ] I am reporting the issue to the correct repository

Expand Down
45 changes: 45 additions & 0 deletions .github/workflows/deploy.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,45 @@
name: Deploy to GitHub Pages

on:
push:
branches:
- main
# Review gh actions docs if you want to further define triggers, paths, etc
# https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#on

permissions:
contents: write

jobs:
deploy:
name: Deploy to GitHub Pages
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- uses: actions/setup-node@v3
with:
node-version: 18
cache: npm

- name: Install dependencies
run: npm install --frozen-lockfile
working-directory: site
- name: Build website
run: npm run build
working-directory: site

# Popular action to deploy to GitHub Pages:
# Docs: https://github.com/peaceiris/actions-gh-pages#%EF%B8%8F-docusaurus
- name: Deploy to GitHub Pages
uses: peaceiris/actions-gh-pages@v3
with:
github_token: ${{ secrets.ACTION_SECRET }}
# Build output to publish to the `gh-pages` branch:
publish_dir: site/build
# The following lines assign commit authorship to the official
# GH-Actions bot for deploys to `gh-pages` branch:
# https://github.com/actions/checkout/issues/13#issuecomment-724415212
# The GH actions bot is used by default if you didn't specify the two fields.
# You can swap them out with your own user credentials.
user_name: github-actions[bot]
user_email: 41898282+github-actions[bot]@users.noreply.github.com
26 changes: 26 additions & 0 deletions .github/workflows/test-deploy.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
name: Test Docs Deployment

on:
pull_request:
branches:
- main
# Review gh actions docs if you want to further define triggers, paths, etc
# https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#on

jobs:
test-deploy:
name: Test docs deployment
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- uses: actions/setup-node@v3
with:
node-version: 18
cache: npm

- name: Install dependencies
run: npm install --frozen-lockfile
working-directory: site
- name: Test build website
run: npm run build
working-directory: site
3 changes: 1 addition & 2 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -12,5 +12,4 @@ lib/httpd/fsdata.c
modules/Custom.cmake
.idea
cmake-*
env.ini

env.ini
10 changes: 5 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@

## Links

[Downloads](https://gp2040-ce.info/#/download) | [Installation](https://gp2040-ce.info/#/installation) | [Wiring](https://gp2040-ce.info/#/wiring) | [Usage](https://gp2040-ce.info/#/usage) | [FAQ](https://gp2040-ce.info/#/faq) | [GitHub](https://github.com/OpenStickCommunity/GP2040-CE)
[Downloads](https://gp2040-ce.info/downloads/download-page) | [Installation](https://gp2040-ce.info/installation) | [Wiring](https://gp2040-ce.info/controller-build/wiring) | [Usage](https://gp2040-ce.info/usage) | [FAQ](https://gp2040-ce.info/faq/faq-general) | [GitHub](https://github.com/OpenStickCommunity/GP2040-CE)

Full documentation can be found at <https://gp2040-ce.info>

Expand All @@ -38,16 +38,16 @@ Full documentation can be found at <https://gp2040-ce.info>
* Left and Right stick emulation via D-pad inputs as well as dedicated toggle switches.
* Dual direction via D-pad + LS/RS.
* Reversed input via a button.
* [Turbo and Turbo LED](https://gp2040-ce.info/#/add-ons/turbo) with selectable speed
* [Turbo and Turbo LED](https://gp2040-ce.info/add-ons/turbo) with selectable speed
* Per-button RGB LED support.
* PWM Player indicator LED support (XInput only).
* Multiple LED profiles support.
* Support for 128x64 monochrome I2C displays - SSD1306, SH1106, and SH1107 compatible.
* Custom startup splash screen and easy image upload via web configuration.
* Support for passive buzzer speaker (3v or 5v).
* [Built-in, embedded web configuration](https://gp2040-ce.info/#/web-configurator) - No download required!
* [Built-in, embedded web configuration](https://gp2040-ce.info/web-configurator) - No download required!

Visit the [GP2040-CE Usage](https://gp2040-ce.info/#/usage) page for more details.
Visit the [GP2040-CE Usage](https://gp2040-ce.info/usage) page for more details.

## Performance

Expand All @@ -58,7 +58,7 @@ Input latency is tested using the methodology outlined at [WydD's inputlag.scien
| v0.7.5 | All modes (except PS4) | 1 ms | 0.45 ms | 1.28 ms | 0.77 ms | 0.24 ms | 96.27% | 3.73% | 0% |
| v0.7.5 | PS4 Mode | 1 ms | 1.34 ms | 2.01 ms | 1.72 ms | 0.16 ms | 90.55% | 9.45% | 0% |

Full results can be found in the [GP2040-CE Firmware Latency Test Results](https://raw.githubusercontent.com/OpenStickCommunity/GP2040-CE/main/docs/latency_tests/GP2040-CE_Firmware_Latency_Test_Results.xlsx) .xlsx Sheet.
Full results can be found in the [GP2040-CE Firmware Latency Test Results](https://raw.githubusercontent.com/OpenStickCommunity/GP2040-CE/main/site/latency_tests/GP2040-CE_Firmware_Latency_Test_Results.xlsx) .xlsx Sheet.

## Support

Expand Down
2 changes: 1 addition & 1 deletion configs/AlpacaOwO/BoardConfig.h
Original file line number Diff line number Diff line change
Expand Up @@ -276,7 +276,7 @@
#define KEY_BUTTON_A1 HID_KEY_9 // A1 / Guide / Home / PS / 13 / ~
#define KEY_BUTTON_A2 HID_KEY_F2 // A2 / ~ / Capture / ~ / 14 / ~

// For details on this, see: https://gp2040-ce.info/#/development?id=i2c-display-splash
// For details on this, see: https://gp2040-ce.info/development?id=i2c-display-splash
#define DEFAULT_SPLASH \
0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00, \
0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00, \
Expand Down
2 changes: 1 addition & 1 deletion configs/BentoBox/BoardConfig.h
Original file line number Diff line number Diff line change
Expand Up @@ -254,7 +254,7 @@
#define KEY_BUTTON_A1 HID_KEY_9 // A1 / Guide / Home / PS / 13 / ~
#define KEY_BUTTON_A2 HID_KEY_F2 // A2 / ~ / Capture / ~ / 14 / ~

// For details on this, see: https://gp2040-ce.info/#/development?id=i2c-display-splash
// For details on this, see: https://gp2040-ce.info/development/firmware-development#i2c-display-splash
#define DEFAULT_SPLASH \
0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00, \
0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00, \
Expand Down
2 changes: 1 addition & 1 deletion configs/Pico/BoardConfig.h
Original file line number Diff line number Diff line change
Expand Up @@ -317,7 +317,7 @@
#define PSPASSTHROUGH_HOST_PIN_DPLUS -1
#define PSPASSTHROUGH_HOST_PIN_5V -1

// For details on this, see: https://gp2040-ce.info/#/development?id=i2c-display-splash
// For details on this, see: /https://gp2040-ce.info/development?id=i2c-display-splash
arntsonl marked this conversation as resolved.
Show resolved Hide resolved
#define DEFAULT_SPLASH \
0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00, \
0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00, \
Expand Down
2 changes: 1 addition & 1 deletion configs/PicoW/BoardConfig.h
Original file line number Diff line number Diff line change
Expand Up @@ -298,7 +298,7 @@
#define KEYBOARD_HOST_PIN_DPLUS -1
#define KEYBOARD_HOST_PIN_5V -1

// For details on this, see: https://gp2040-ce.info/#/development?id=i2c-display-splash
// For details on this, see: https://gp2040-ce.info/development/firmware-development#i2c-display-splash
#define DEFAULT_SPLASH \
0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00, \
0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00, \
Expand Down
53 changes: 0 additions & 53 deletions docs/_sidebar.md

This file was deleted.

26 changes: 0 additions & 26 deletions docs/add-ons.md

This file was deleted.

3 changes: 0 additions & 3 deletions docs/add-ons/keyboard-host.md

This file was deleted.

5 changes: 0 additions & 5 deletions docs/add-ons/player-number.md

This file was deleted.

5 changes: 0 additions & 5 deletions docs/add-ons/ps-passthrough.md

This file was deleted.

18 changes: 0 additions & 18 deletions docs/add-ons/usb-host-based-add-ons.md

This file was deleted.

Loading