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

[Refactor/InhaBas#167] 리드미 수정 - 구글 컨벤션 반영 #220

Merged
merged 2 commits into from
Jan 17, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
12 changes: 1 addition & 11 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -100,16 +100,6 @@ git pull upstream master

PR을 제출할 때는 다음 가이드라인을 따라야 합니다:

- IBAS Style Convention을 참고하세요.
- Style Convention을 참고하세요.
[STYLE-CONVENTION.md](STYLE-CONVENTION.md)
- 작성한 코드가 기존 코드 스타일을 준수하고 있는지 확인해야 합니다.

Intellij를 사용하는 경우 아래 포멧팅을 참고하세요:

- xml: [`ibas_intellij_formatting.xml`](
/docs/back-end/ibas_intellij_formatting.xml).

Eclipse / VSCOde를 사용하는 경우 아래 포멧팅을 참고하세요:

- xml: [`eclipse_formatting.xml`](
/docs/back-end/ibas_eclipse_formatting.xml).
66 changes: 22 additions & 44 deletions STYLE-CONVENTION.md
Original file line number Diff line number Diff line change
@@ -1,65 +1,43 @@

# IBAS Project Style Convention

이 문서는 IBAS Project의 Style Convention에 대해 설명하는 문서입니다. IBAS Project는 코드 품질과 가독성을 유지하기 위해 일관된 스타일 규약을 따릅니다. 이러한 스타일 규약을 정함으로써 프로젝트 참여자들이 명확하고 일관된 방식으로 코드를 작성할 수 있으며, 협업과 코드 유지 관리를 용이하게 할 수 있습니다.
이 문서는 IBAS Project의 Style Convention에 대해 설명하는 문서입니다. IBAS Project는 코드 품질과 가독성을 유지하기 위해 일관된 스타일 규약을 따릅니다. 이러한 스타일 규약을 통해 프로젝트 참여자들이 명확하고 일관된 방식으로 코드를 작성할 수 있으며, 협업과 코드 유지 관리를 용이하게 할 수 있습니다.

## IBAS 코드 스타일 포멧팅 사용하기
## IBAS Style Convention 논의사항

### IntelliJ 전용 IBAS JAVA 코드 스타일 포멧

- xml: [`ibas_intellij_formatting.xml`](
/docs/back-end/ibas_intellij_formatting.xml).

### Eclipse 전용 IBAS JAVA 코드 스타일 포멧

- xml: [`ibas_eclipse_formatting.xml`](
/docs/back-end/ibas_eclipse_formatting.xml).
IBAS Project의 주요한 Style Convention은 깃허브 Issue를 통해 논의되고 정해집니다. 프로젝트의 모든 멤버가 스타일 결정에 참여하고 의견을 제시할 수 있습니다.

### IntelliJ에서 사용하기
- [import 시 * 와일드카드 사용여부 논의](https://github.com/InhaBas/Inhabas.com-api/issues/187)
- [PR Merge 방식에 대한 논의](https://github.com/InhaBas/Inhabas.com-api/issues/188)
- [JUnit / AssertJ 채택 논의](https://github.com/InhaBas/Inhabas.com-api/issues/165)

IntelliJ IDEA에서 IBAS JAVA 코드 스타일 포맷팅을 사용하려면 다음과 같은 단계를 따르면 됩니다:
## Documentation style

1. IntelliJ IDEA를 열고 프로젝트를 로드합니다.
2. File > Settings > Editor > Code Style로 이동합니다.
3. 오른쪽 상단의 설정 톱니바퀴 아이콘을 클릭한 다음, Import Scheme > IntelliJ IDEA code style XML을 선택합니다.
4. IBAS_intellij_formatting.xml 파일을 찾아서 선택하고, 'OK'를 클릭합니다.
IBAS Project의 기본 스타일은 [Google Developer Documentation Style Guide](https://developers.google.com/style)를 따르고 있습니다.

### Eclipse에서 사용하기
## Google Developer Document Style 적용

Eclipse에서 IBAS JAVA 코드 스타일 포맷팅을 사용하려면 다음과 같은 단계를 따르면 됩니다:
### Backend

1. Eclipse를 열고 프로젝트를 로드합니다.
2. Window > Preferences > Java > Code Style > Formatter로 이동합니다.
3. 'Import' 버튼을 클릭합니다.
4. 다운로드한 eclipse_formatting.xml 파일을 찾아서 선택하고, 'Open'을 클릭합니다.
5. 새로운 포맷팅 프로필이 리스트에 나타납니다. 이 프로필을 선택하고 'OK' 또는 'Apply and Close'를 클릭합니다.
#### 포멧 적용

### VSCode에서 사용하기
1. 구글 스타일 깃허브에서 스타일 다운로드

VSCode에서 IBAS JAVA 코드 스타일 포맷팅을 사용하려면 다음과 같은 단계를 따르면 됩니다:
- IntelliJ: [intellij-java-google-style.xml](https://github.com/google/styleguide/blob/gh-pages/intellij-java-google-style.xml)

1. VSCode를 열고 Java 프로젝트를 로드합니다.
2. Java Extension Pack이 설치되어 있지 않다면, VSCode 마켓플레이스에서 설치합니다.
3. 프로젝트의 루트 디렉토리에 .settings 폴더를 생성합니다 (이미 존재한다면 생략).
4. .settings 폴더 내에 org.eclipse.jdt.core.prefs 파일을 생성합니다.
5. eclipse_formatting.xml 파일의 내용을 org.eclipse.jdt.core.prefs 파일에 복사하거나, 이 파일을 직접 .settings 폴더에 배치합니다.
6. VSCode 설정에서 Java 포맷팅을 Eclipse 설정으로 지정합니다. settings.json 파일에 다음과 같은 설정을 추가합니다:
- Eclipse: [eclipse-java-google-style.xml](https://github.com/google/styleguide/blob/gh-pages/eclipse-java-google-style.xml)

```json
"java.format.settings.url": "file:///<path_to_your_project>/.settings/org.eclipse.jdt.core.prefs",
"java.format.settings.profile": "IBAS Java Backend Style"
```
2. IDE에서 스타일 포멧 적용

위 경로에서 <path_to_your_project>는 실제 프로젝트의 경로로 대체해야 합니다.
#### 코드 스타일 교정

### IBAS Style Convention 논의사항
구글 코드 스타일에 맞게 코드 스타일 변경하는 명령어.

IBAS Project의 주요한 Style Convention은 깃허브 Issue를 통해 논의되고 정해집니다. 프로젝트의 모든 멤버가 스타일 결정에 참여하고 의견을 제시할 수 있습니다.
프로젝트 경로 터미널에서 아래 명령어 입력.

- [import 시 * 와일드카드 사용여부 논의](https://github.com/InhaBas/Inhabas.com-api/issues/187)
- [PR Merge 방식에 대한 논의](https://github.com/InhaBas/Inhabas.com-api/issues/188)
- [JUnit / AssertJ 채택 논의](https://github.com/InhaBas/Inhabas.com-api/issues/165)
- 리눅스: `./gradlew spotlessApply`
- 윈도우: `.\gradlew spotlessApply`

### Documentation style
### Frontend

IBAS Project의 기본 스타일은 [Google Developer Documentation Style Guide](https://developers.google.com/style)를 따르고 있습니다.
prittier 이용해서 구글 스타일 컨벤션 적용.
46 changes: 0 additions & 46 deletions docs/back-end/ibas_eclipse_formatting.xml

This file was deleted.

92 changes: 0 additions & 92 deletions docs/back-end/ibas_intellij_formatting.xml

This file was deleted.

Loading