go,go-*,gofmt,goimports,golangci-lint: add Korean translation (#14190)

pages.ko/common/go-bug.md

@@ -0,0 +1,8 @@
+# go bug
+
+> 버그 보고.
+> 더 많은 정보: <https://golang.org/cmd/go/#hdr-Start_a_bug_report>.
+
+- 버그 보고를 시작하기 위해 웹 페이지 열기:
+
+`go bug`

pages.ko/common/go-build.md

@@ -0,0 +1,20 @@
+# go build
+
+> Go 소스 컴파일.
+> 더 많은 정보: <https://golang.org/cmd/go/#hdr-Compile_packages_and_dependencies>.
+
+- 'package main' 파일 컴파일 (출력은 확장자가 없는 파일 이름):
+
+`go build {{경로/대상/main.go}}`
+
+- 출력 파일 이름을 지정하여 컴파일:
+
+`go build -o {{경로/대상/바이너리}} {{경로/대상/소스.go}}`
+
+- 패키지 컴파일:
+
+`go build -o {{경로/대상/바이너리}} {{경로/대상/패키지}}`
+
+- 데이터 경쟁 감지를 활성화하여 메인 패키지를 실행 파일로 컴파일:
+
+`go build -race -o {{경로/대상/실행_파일}} {{경로/대상/메인/패키지}}`

pages.ko/common/go-clean.md

@@ -0,0 +1,20 @@
+# go clean
+
+> 오브젝트 파일과 캐시 파일 제거.
+> 더 많은 정보: <https://golang.org/cmd/go/#hdr-Remove_object_files_and_cached_files>.
+
+- 실제로 제거하지 않고 제거 명령 출력:
+
+`go clean -n`
+
+- 빌드 캐시 삭제:
+
+`go clean -cache`
+
+- 모든 캐시된 테스트 결과 삭제:
+
+`go clean -testcache`
+
+- 모듈 캐시 삭제:
+
+`go clean -modcache`

pages.ko/common/go-doc.md

@@ -0,0 +1,24 @@
+# go doc
+
+> 패키지나 심볼에 대한 문서 보기.
+> 더 많은 정보: <https://golang.org/cmd/go/#hdr-Show_documentation_for_package_or_symbol>.
+
+- 현재 패키지에 대한 문서 보기:
+
+`go doc`
+
+- 패키지 문서 및 내보내진 기호 보기:
+
+`go doc {{encoding/json}}`
+
+- 기호의 문서도 함께 보기:
+
+`go doc -all {{encoding/json}}`
+
+- 소스도 함께 보기:
+
+`go doc -all -src {{encoding/json}}`
+
+- 특정 기호 보기:
+
+`go doc -all -src {{encoding/json.Number}}`

pages.ko/common/go-env.md

@@ -0,0 +1,20 @@
+# go env
+
+> Go 툴체인이 사용하는 환경 변수를 관리합니다.
+> 더 많은 정보: <https://golang.org/cmd/go/#hdr-Print_Go_environment_information>.
+
+- 모든 환경 변수 표시:
+
+`go env`
+
+- 특정 환경 변수 표시:
+
+`go env {{GOPATH}}`
+
+- 환경 변수를 특정 값으로 설정:
+
+`go env -w {{GOBIN}}={{경로/대상/폴더}}`
+
+- 환경 변수의 값을 재설정:
+
+`go env -u {{GOBIN}}`

pages.ko/common/go-fix.md

@@ -0,0 +1,8 @@
+# go fix
+
+> 패키지를 새로운 API를 사용하도록 업데이트.
+> 더 많은 정보: <https://golang.org/cmd/go/#hdr-Update_packages_to_use_new_APIs>.
+
+- 패키지를 새로운 API를 사용하도록 업데이트:
+
+`go fix {{packages}}`

pages.ko/common/go-fmt.md

@@ -0,0 +1,24 @@
+# go fmt
+
+> Go 소스 파일을 포맷하고 변경된 파일 이름을 출력합니다.
+> 더 많은 정보: <https://pkg.go.dev/cmd/go#hdr-Gofmt__reformat__package_sources>.
+
+- 현재 디렉토리의 Go 소스 파일 포맷:
+
+`go fmt`
+
+- 가져오기 경로(`$GOPATH/src`)에 있는 특정 Go 패키지 포맷:
+
+`go fmt {{경로/대상/패키지}}`
+
+- 현재 디렉토리와 모든 하위 디렉토리의 패키지 포맷 (`...`을 주의하세요):
+
+`go fmt {{./...}}`
+
+- 포맷 명령이 실행될 때 어떤 명령이 실행될지 출력하고 실제로 수정하지 않음:
+
+`go fmt -n`
+
+- 포맷 명령이 실행될 때 실행되는 명령을 출력:
+
+`go fmt -x`

pages.ko/common/go-generate.md

@@ -0,0 +1,8 @@
+# go generate
+
+> 소스 파일 내에서 명령을 실행하여 Go 파일 생성.
+> 더 많은 정보: <https://golang.org/cmd/go/#hdr-Generate_Go_files_by_processing_source>.
+
+- 소스 파일 내에서 명령을 실행하여 Go 파일 생성:
+
+`go generate`

pages.ko/common/go-get.md

@@ -0,0 +1,16 @@
+# go get
+
+> 의존성 패키지를 추가하거나 레거시 GOPATH 모드에서 패키지를 다운로드.
+> 더 많은 정보: <https://pkg.go.dev/cmd/go#hdr-Add_dependencies_to_current_module_and_install_them>.
+
+- 모듈 모드에서 `go.mod`에 지정된 패키지를 추가하거나 GOPATH 모드에서 패키지 설치:
+
+`go get {{example.com/pkg}}`
+
+- 모듈 인식 모드에서 지정된 버전으로 패키지 수정:
+
+`go get {{example.com/pkg}}@{{v1.2.3}}`
+
+- 지정된 패키지 제거:
+
+`go get {{example.com/pkg}}@{{none}}`

pages.ko/common/go-install.md

@@ -0,0 +1,20 @@
+# go install
+
+> import 경로로 지정된 패키지를 컴파일하고 설치.
+> 더 많은 정보: <https://pkg.go.dev/cmd/go#hdr-Compile_and_install_packages_and_dependencies>.
+
+- 현재 패키지를 컴파일하고 설치:
+
+`go install`
+
+- 특정 로컬 패키지를 컴파일하고 설치:
+
+`go install {{경로/대상/패키지}}`
+
+- 현재 디렉토리의 `go.mod`를 무시하고 프로그램의 최신 버전 설치:
+
+`go install {{golang.org/x/tools/gopls}}@{{최신}}`
+
+- 현재 디렉토리의 `go.mod`에 의해 선택된 버전으로 프로그램 설치:
+
+`go install {{golang.org/x/tools/gopls}}`

pages.ko/common/go-list.md

@@ -0,0 +1,20 @@
+# go list
+
+> 패키지 또는 모듈 나열.
+> 더 많은 정보: <https://golang.org/cmd/go/#hdr-List_packages_or_modules>.
+
+- 패키지 나열:
+
+`go list ./...`
+
+- 표준 패키지 나열:
+
+`go list std`
+
+- JSON 형식으로 패키지 나열:
+
+`go list -json time net/http`
+
+- 모듈 종속성과 이용 가능한 업데이트 나열:
+
+`go list -m -u all`

pages.ko/common/go-mod.md

@@ -0,0 +1,24 @@
+# go mod
+
+> 모듈 유지 관리.
+> 더 많은 정보: <https://golang.org/cmd/go/#hdr-Module_maintenance>.
+
+- 현재 디렉터리에 새 모듈 초기화:
+
+`go mod init {{모듈_이름}}`
+
+- 모듈을 로컬 캐시로 다운로드:
+
+`go mod download`
+
+- 누락된 모듈 추가 및 사용하지 않는 모듈 제거:
+
+`go mod tidy`
+
+- 의존성이 예상된 내용을 가지고 있는지 확인:
+
+`go mod verify`
+
+- 모든 의존성의 소스를 vendor 디렉터리에 복사:
+
+`go mod vendor`

pages.ko/common/go-run.md

@@ -0,0 +1,12 @@
+# go run
+
+> Go 코드를 컴파일하고 바이너리를 저장하지 않고 실행.
+> 더 많은 정보: <https://pkg.go.dev/cmd/go#hdr-Compile_and_run_Go_program>.
+
+- Go 파일 실행:
+
+`go run {{경로/대상/파일.go}}`
+
+- 메인 Go 패키지 실행:
+
+`go run {{경로/대상/패키지}}`

pages.ko/common/go-test.md

@@ -0,0 +1,28 @@
+# go test
+
+> Go 패키지를 테스트합니다 (`_test.go`로 끝나는 파일이어야 함).
+> 더 많은 정보: <https://golang.org/cmd/go/#hdr-Testing_flags>.
+
+- 현재 디렉터리에 있는 패키지 테스트:
+
+`go test`
+
+- 현재 디렉터리의 패키지를 [v]자세히 테스트:
+
+`go test -v`
+
+- 현재 디렉터리와 모든 하위 디렉터리의 패키지 테스트 (`...` 주의):
+
+`go test -v ./...`
+
+- 현재 디렉터리의 패키지를 테스트하고 모든 벤치마크 실행:
+
+`go test -v -bench .`
+
+- 현재 디렉터리의 패키지를 테스트하고 50초 동안 모든 벤치마크 실행:
+
+`go test -v -bench . -benchtime {{50s}}`
+
+- 커버리지 분석으로 패키지 테스트:
+
+`go test -cover`

pages.ko/common/go-tool.md

@@ -0,0 +1,25 @@
+# go tool
+
+> Go 도구 또는 명령 실행.
+> Go 명령을 독립 실행형 바이너리로 실행하여 주로 디버깅에 사용.
+> 더 많은 정보: <https://pkg.go.dev/cmd/go#hdr-Run_specified_go_tool>.
+
+- 사용 가능한 도구 나열:
+
+`go tool`
+
+- go link 도구 실행:
+
+`go tool link {{경로/대상/main.o}}`
+
+- 실행될 명령을 출력하지만 실제로 실행하지 않음 (`whereis`와 유사):
+
+`go tool -n {{명령}} {{인수들}}`
+
+- 지정된 도구에 대한 문서 보기:
+
+`go tool {{명령}} --help`
+
+- 사용 가능한 모든 교차 컴파일 대상 나열:
+
+`go tool dist list`

pages.ko/common/go-version.md

@@ -0,0 +1,12 @@
+# go version
+
+> Go 버전을 표시.
+> 더 많은 정보: <https://golang.org/cmd/go/#hdr-Print_Go_version>.
+
+- 버전 표시:
+
+`go version`
+
+- 특정 실행 파일을 빌드하는 데 사용된 Go 버전 표시:
+
+`go version {{경로/대상/실행파일}}`

pages.ko/common/go-vet.md

@@ -0,0 +1,29 @@
+# go vet
+
+> Go 소스 코드를 검사하고 의심스러운 구조를 보고합니다 (예: Go 소스 파일을 린트).
+> 문제가 발견되면 go vet는 0이 아닌 종료 코드를 반환하고, 문제가 없으면 0 종료 코드를 반환합니다.
+> 더 많은 정보: <https://pkg.go.dev/cmd/vet>.
+
+- 현재 디렉토리의 Go 패키지 검사:
+
+`go vet`
+
+- 지정된 경로의 Go 패키지 검사:
+
+`go vet {{경로/대상/파일_또는_폴더}}`
+
+- go vet로 실행할 수 있는 사용 가능한 검사 목록 나열:
+
+`go tool vet help`
+
+- 특정 검사의 세부정보 및 플래그 보기:
+
+`go tool vet help {{검사_이름}}`
+
+- 문제 있는 줄과 그 주변의 N 줄을 표시:
+
+`go vet -c={{N}}`
+
+- 분석 결과와 오류를 JSON 형식으로 출력:
+
+`go vet -json`

pages.ko/common/go.md

@@ -0,0 +1,33 @@
+# go
+
+> Go 소스 코드를 관리.
+> `build`와 같은 일부 하위 명령에는 자체 사용 설명서가 있습니다.
+> 더 많은 정보: <https://golang.org>.
+
+- 패키지 다운로드 및 설치 (import 경로로 지정):
+
+`go get {{패키지_경로}}`
+
+- 소스 파일 컴파일 및 실행 (`main` 패키지를 포함해야 함):
+
+`go run {{파일}}.go`
+
+- 소스 파일을 지정한 이름의 실행 파일로 컴파일:
+
+`go build -o {{실행_파일}} {{파일}}.go`
+
+- 현재 디렉토리에 있는 패키지 컴파일:
+
+`go build`
+
+- 현재 패키지의 모든 테스트 케이스 실행 (`_test.go`로 끝나야 함):
+
+`go test`
+
+- 현재 패키지 컴파일 및 설치:
+
+`go install`
+
+- 현재 디렉토리에 새 모듈 초기화:
+
+`go mod init {{모듈_이름}}`

pages.ko/common/gofmt.md

@@ -0,0 +1,20 @@
+# gofmt
+
+> Go 소스 코드를 포맷합니다.
+> 더 많은 정보: <https://golang.org/cmd/gofmt/>.
+
+- 파일을 포맷하고 결과를 콘솔에 표시:
+
+`gofmt {{source.go}}`
+
+- 파일을 포맷하여 원본 파일을 덮어쓰기:
+
+`gofmt -w {{source.go}}`
+
+- 파일을 포맷하고 코드를 단순화한 후 원본 파일을 덮어쓰기:
+
+`gofmt -s -w {{source.go}}`
+
+- 모든 오류(불필요한 오류 포함)를 출력:
+
+`gofmt -e {{source.go}}`

pages.ko/common/goimports.md

@@ -0,0 +1,20 @@
+# goimports
+
+> Go 언어의 import 줄을 업데이트하여 누락된 항목을 추가하고 참조되지 않은 항목을 제거합니다.
+> 더 많은 정보: <https://godoc.org/golang.org/x/tools/cmd/goimports>.
+
+- 완료된 import 소스 파일 표시:
+
+`goimports {{경로/대상/파일.go}}`
+
+- 결과를 `stdout` 대신 소스 파일에 다시 작성:
+
+`goimports -w {{경로/대상/파일.go}}`
+
+- 차이점을 표시하고 결과를 소스 파일에 다시 작성:
+
+`goimports -w -d {{경로/대상/파일.go}}`
+
+- 3rd-party 패키지 이후에 import 접두사 문자열 설정 (쉼표로 구분된 목록):
+
+`goimports -local {{경로/대상/패키지1,경로/대상/패키지2,...}} {{경로/대상/파일.go}}`

pages.ko/common/golangci-lint.md

@@ -0,0 +1,16 @@
+# golangci-lint
+
+> 병렬 처리, 스마트하고 빠른 Go 린터 실행 도구로 주요 IDE와 통합되며 YAML 구성을 지원합니다.
+> 더 많은 정보: <https://golangci-lint.run/welcome/quick-start/>.
+
+- 현재 폴더에서 린터 실행:
+
+`golangci-lint run`
+
+- 활성화 및 비활성화된 린터 목록 표시 (참고: 비활성화된 린터는 마지막에 표시되며, 활성화된 린터로 착각하지 마세요):
+
+`golangci-lint linters`
+
+- 특정 린터를 이 실행에서 [E]nable:
+
+`golangci-lint run --enable {{린터}}`