mirror of
https://github.com/BoostIo/Boostnote
synced 2025-12-12 17:26:17 +00:00
update korean docs in docs/ko/ (#3454)
* update korean docs in docs/ko/ * Fix typo Co-authored-by: Junyoung Choi <rokt33r.choi@gmail.com>
This commit is contained in:
@@ -5,8 +5,6 @@
|
||||
* npm: 6.x
|
||||
* node: 8.x
|
||||
|
||||
`$ grunt pre-build`를 `npm v5.x`에서 실행할 수 없기 때문에, 반드시 `npm v4.x`를 사용하셔야 합니다.
|
||||
|
||||
## 개발
|
||||
|
||||
개발에 있어서 Webpack HRM을 사용합니다.
|
||||
@@ -29,6 +27,34 @@ $ yarn run dev
|
||||
> 1. 콤포넌트의 컨스트럭터 함수를 수정할 경우
|
||||
> 2. 새로운 CSS코드를 추가할 경우(1.과 같은 이유: CSS클래스는 콤포넌트마다 다시 만들어 지는데, 이 작업은 컨스트럭터에서 일어납니다.)
|
||||
|
||||
## Pull Request에 사용된 코드를 적용하는 방법
|
||||
관련된 Pull request 페이지를 방문하여, url 스트링 마지막에 표기된 PR 번호를 확인합니다.
|
||||
<pre>
|
||||
https://github.com/BoostIO/Boostnote/pull/2794
|
||||
</pre>
|
||||
아래의 커맨드를 실행하면서, \<PR> 대신에 위에서 확인한 번호를 입력합니다 (부등호 신호는 빼고 입력하세요).
|
||||
위에 보여진 예시의 경우, \<PR> 자리에 2794를 입력하면 됩니다.
|
||||
|
||||
_본인의 로컬 컴퓨터에 마스터 브랜치가 복사되어 있지 않은 경우_
|
||||
```
|
||||
git clone https://github.com/BoostIO/Boostnote.git
|
||||
cd Boostnote
|
||||
git fetch origin pull/<PR>/head:<PR>
|
||||
git checkout <PR>
|
||||
```
|
||||
|
||||
_이미 마스터 브랜치를 로컬 컴퓨터에 저장해둔 경우_
|
||||
```
|
||||
git fetch origin pull/<PR>/head:<PR>
|
||||
git checkout <PR>
|
||||
```
|
||||
|
||||
_To compile and run the code_
|
||||
```
|
||||
yarn
|
||||
yarn run dev
|
||||
```
|
||||
|
||||
## 배포
|
||||
|
||||
Boostnote에서는 배포 자동화를 위하여 그런트를 사용합니다.
|
||||
@@ -43,3 +69,31 @@ grunt pre-build
|
||||
실행 파일은 `dist`에서 찾을 수 있습니다. 이 경우, 인증이 되어있지 않기 때문에 업데이터는 사용할 수 없습니다.
|
||||
|
||||
필요로 하다면, 이 실행파일에 Codesign나 Authenticode등의 서명을 할 수 있습니다.
|
||||
|
||||
## 독자적인 배포판을 제작하는 방법 (deb, rpm)
|
||||
|
||||
배포판 패키지를 제작하려면 (우분투, 페도라 등) 리눅스 플랫폼에서 `grunt build` 커맨드를 실행하면 됩니다.
|
||||
|
||||
> 참조: 동일한 환경에서 `.deb` 파일과 `.rpm` 파일을 모두 만들 수 있습니다.
|
||||
|
||||
지원되는 버전의 `node`와 `npm`을 설치한 다음, 빌드에 필요한 패키지를 설치합니다.
|
||||
|
||||
우분투/데비안 환경 (Ubuntu/Debian):
|
||||
|
||||
```
|
||||
$ sudo apt-get install -y rpm fakeroot
|
||||
```
|
||||
|
||||
페도라 환경 (Fedora):
|
||||
|
||||
```
|
||||
$ sudo dnf install -y dpkg dpkg-dev rpm-build fakeroot
|
||||
```
|
||||
|
||||
그 다음 `grunt build` 커맨드를 실행합니다.
|
||||
|
||||
```
|
||||
$ grunt build
|
||||
```
|
||||
|
||||
`dist` 디렉토리에 `.deb` 파일과 `.rpm` 파일이 새롭게 생성됩니다.
|
||||
|
||||
@@ -1,5 +1,7 @@
|
||||
# Boostnote의 디버그 방법(Electron app)
|
||||
|
||||
## 구글 크롬 Developer Tools를 사용한 디버깅
|
||||
|
||||
Boostnote는 Electron 애플리케이션이므로 Chromium위에서 작동합니다. 그렇기 때문에 개발자분들은 Google Chrome 브라우저에서 처럼 `Developer Tools`를 사용하실 수 있습니다.
|
||||
|
||||
다음과 같이 `Developer Tools`를 실행할 수 있습니다:
|
||||
@@ -10,12 +12,26 @@ Boostnote는 Electron 애플리케이션이므로 Chromium위에서 작동합니
|
||||
|
||||
에러가 발생할 때에는, 에러메시지가 `console`위에 표시 됩니다.
|
||||
|
||||
## 디버깅
|
||||
### 디버깅
|
||||
예를들면 `debugger`를 사용하여 코드 안에서 다음과 같이 일시 정지지점을 설정할 수 있습니다:
|
||||
|
||||

|
||||
|
||||
이는 단순한 하나의 예시에 불과합니다. 자기자신에게 가장 잘 맞는 디버그 방법을 찾는 것도 좋을 것 입니다.
|
||||
|
||||
## 참고
|
||||
### 참고
|
||||
* [디버그에 관한 Google Chrome의 공식 문서](https://developer.chrome.com/devtools)
|
||||
|
||||
## 비주얼 스튜디오 코드를 사용한 디버깅
|
||||
|
||||
1. **[크롬 디버깅 플러그인](https://marketplace.visualstudio.com/items?itemName=msjsdiag.debugger-for-chrome 'Install Debugger for Chrome')** 을 비주얼 스튜디오 코드에 설치한 후, 프로그램을 닫았다가 재실행합니다.
|
||||
2. **Shift+Command+B** 키를 누르거나, **Terminal** 메뉴 하단에 있는 **Run Build Task** 메뉴를 선택한 후 **Build Boostnote** 를 선택합니다. 아니면 터미널에서 곧바로 `yarn run watch`를 실행해도 됩니다.
|
||||
3. 위의 절차가 실행되고 있을 때, 사이드바 **Activity Bar**에서 **Debug view**를 선택합니다. 키보드 단축키로는 **Shift+Command+D**를 눌러도 됩니다..
|
||||
4. **Debug configuration**에서 **Boostnote All** 설정을 선택한 후, 초록색 화살표를 클릭하거나 **F5** 키를 누르면 디버깅이 시작됩니다.
|
||||
5. 이 시점에서는 **Boostnote**가 실행되고 있을 텐데, 두 개의 프로세스가 진행중인 것을 볼 수 있을 겁니다. 바로 **Boostnote Main** 프로세스와 **Boostnote Renderer** 프로세스입니다. 이제 비주얼 스튜디오 코드에서 곧바로 **디버깅 정지지점 (debug breakpoint)** 을 설정할 수 있습니다. 만약에 지정한 **정지지점 (breakpoint)** 이 등록되지 않는다면, **Boostnote Renderer** 와 **Boostnote Main** 프로세스 사이를 번갈아 확인해 보아야 합니다.
|
||||
|
||||
|
||||
### 참고
|
||||
|
||||
- [일렉트론 애플리케이션 디버깅 공식 튜토리얼](https://electronjs.org/docs/tutorial/application-debugging)
|
||||
- [비쥬얼 스튜디오 코드용 크롬 디버깅 플러그인](https://marketplace.visualstudio.com/items?itemName=msjsdiag.debugger-for-chrome)
|
||||
|
||||
Reference in New Issue
Block a user