qmk_configurator

양자 기계 키보드 구성 기

QMK Configurator는 QMK_Firmware에서 지원되는 키보드 용 펌웨어 파일을 쉽게 작성하는 데 사용되는 온라인 도구입니다. 이 도구는 https://config.qmk.fm에 있습니다.

QMK 구성자는 .json keyp 파일을 통해 간단한 Keymap 생성 및 저장을 허용하고 선택한 키보드로 플래시하기 위해 적절한 펌웨어 파일을 생성합니다.

이 프로젝트는 진행중인 작업입니다. 기여를 시작하려면 다음을 참조하십시오.

• 문제

개발

NVM을 설치하고 사용하여 노드 버전을 관리하는 것이 좋습니다. 프로젝트 디렉토리의 루트에는 종속성으로 테스트 된 .NVMRC 파일이 있습니다.

노드 버전을 선택하십시오

nvm use

프로젝트 설정

 yarn install

개발을 위해 컴파일 및 핫 릴로드

 yarn run dev

생산을 위해 컴파일하고 최소화합니다

 yarn run build

테스트를 실행하십시오

 yarn run test

라인 및 수정 파일

 yarn run lint

엔드 투 엔드 테스트를 실행하십시오

서버를 별도로 시작하십시오

 yarn run test:cypress

CI와 같은 엔드 투 엔드 테스트를 실행하십시오

서버를 별도로 시작하십시오

 yarn run test:cypress:ci

단위 테스트를 실행하십시오

 yarn run test:unit

구성을 사용자 정의합니다

구성 참조를 참조하십시오.

도커

이미 웹 서버가없고 아직 웹 서버가 없으면 Docker를 사용할 수 있습니다. 기본적으로 자체 포함 된 환경을 돌립니다.

 docker run -p 8080:80 qmkfm/qmk_configurator:latest

VUE_APP_API_URL 설정하여 다른 백엔드 URL을 지정할 수 있습니다.

 docker run -e VITE_API_URL=http://localhost:8080 -p 8080:80 qmkfm/qmk_configurator:latest

로컬로 개발하려면 볼륨을 사용하여 로컬 파일 시스템을 컨테이너에 묶을 수 있습니다.

 docker run --mount type=volume,source=.,target=/qmk_configurator -p 8080:80 qmkfm/qmk_configurator:latest

도커 이미지 구축

대부분의 경우이 작업을 수행 할 필요가 없으므로 위에서 설명한대로 볼륨 마운트를 사용하여 로컬 트리와 함께 사전 제작 된 이미지를 사용할 수 있습니다.

어떤 이유로 든 직접 구축 해야하는 경우이 명령을 사용할 수 있습니다.

 docker build -t qmk_configurator .

이 과정에는 시간이 걸립니다. 차나 뭔가를 만들고 싶을 수도 있습니다. 완료되면이 명령으로 실행할 수 있습니다.

 docker run -p 8080:80 qmk_configurator

국제화 안내서

이 문서를 참조하십시오