From f8996e8b518cd75ffadbe24fd3a50269cc74f627 Mon Sep 17 00:00:00 2001 From: Wonjang Son Date: Sun, 3 Oct 2021 18:54:59 +0200 Subject: [PATCH 01/16] Implemented code of conduct korean translation --- CODE_OF_CONDUCT-ko.md | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/CODE_OF_CONDUCT-ko.md b/CODE_OF_CONDUCT-ko.md index d07e5d4e93c5c..a5c3bb61caa63 100644 --- a/CODE_OF_CONDUCT-ko.md +++ b/CODE_OF_CONDUCT-ko.md @@ -4,25 +4,25 @@ 우리는 이슈리포팅, 기능 요청, 문서 업데이트, Pull request 또는 Patch 제출 및 기타 활동을 통해 기여하는 모든 사람들을 존중할 것을 약속합니다. -우리는 경험, 성별, 성 정체성 및 표현, 성적 지향, 장애, 외모, 신체 크기, 인종, 나이, 종교 -또는 국적에 관계없이 이 프로젝트에 참여하는 것을 모든 사람에게 +우리는 경험, 성별, 성 정체성 및 표현, 성적 지향, 장애, 외모, 신체 크기, 인종, 나이, 종교 +또는 국적에 관계없이 이 프로젝트에 참여하는 것을 모든 사람에게 괴롭힘 없는 경험으로 만들기 위해 최선을 다하고 있습니다. 허용할 수 없는 행동의 예는 다음과 같다. -* 성적인 언어와 이미지 사용 -* 인신공격 -* 트롤링 또는 모욕/모독성 댓글 -* 공개적이거나 개인적인 괴롭힘 -* 동의없는 집주소 또는 전자주소 등의 개인 정보의 공개 -* 부적절한 것으로 간주될 수 있는 다른 행위 +- 성적인 언어와 이미지 사용 +- 인신공격 +- 트롤링 또는 모욕/모독성 댓글 +- 공개적이거나 개인적인 괴롭힘 +- 동의없는 집주소 또는 전자주소 등의 개인 정보의 공개 +- 부적절한 것으로 간주될 수 있는 다른 행위 프로젝트 유지자는 이 행동 강령을 따르지 않은 댓글, 커밋, 코드, 위키 편집, 이슈와 그 외 다른 기여를 삭제, 수정 또는 거부할 권리와 책임이 있습니다. 또한, 부적당하거나 험악하거나 공격적이거나 해롭다고 생각하는 다른 행동을 한 기여자를 일시적 또는 영구적으로 퇴장시킬 수 있습니다. 이 행동 강령을 채택함으로써 프로젝트 메인테이너들은 이 프로젝트 관리의 모든 측면에 공정하고 -일관되게 이러한 원칙을 적용하기로 약속합니다. 행동 강령을 따르지 않는 프로젝트 메인테이너는 +일관되게 이러한 원칙을 적용하기로 약속합니다. 행동 강령을 따르지 않는 프로젝트 메인테이너는 프로젝트 팀에서 영구히 제명 될 수 있습니다. 이 행동 강령은 개인 프로젝트 또는 해당 커뮤니티를 대표하는 프로젝트 스페이스나 퍼블릭 스페이스 @@ -30,9 +30,9 @@ 모욕적이거나 괴롭힘 또는 기타 용납할 수 없는 행동의 사례는 프로젝트 관리자 victorfelder@gmail.com 에게 연락하여 보고 할 수 있습니다. 모든 불만사항은 검토하고 조사한 뒤 상황에 따라 필요하고 적절하다고 생각되는 -응답을 할 것 입니다. 관리자는 사건의 보고자와 관련한 비밀을 유지할 의무가 있습니다. +응답을 할 것 입니다. 관리자는 사건의 보고자와 관련한 비밀을 유지할 의무가 있습니다. -이 행동 강령은 [기여자 규약][homepage] 의 1.3.0 버전을 변형하였습니다. +이 행동 강령은 [기여자 규약][homepage] 의 1.3.0 버전을 변형하였습니다. 그 내용은 https://contributor-covenant.org/version/1/3/0/ 에서 확인할 수 있습니다. [homepage]: https://contributor-covenant.org From 976dca236e6ff78697ae27de10f2789ebe97282d Mon Sep 17 00:00:00 2001 From: Wonjang Son Date: Sun, 3 Oct 2021 18:56:15 +0200 Subject: [PATCH 02/16] Implemented CONTRIBUTING korean translation --- CONTRIBUTING-kr.md | 220 +++++++++++++++++++++++++++++++++++++++++++++ CONTRIBUTING.md | 48 +++++----- 2 files changed, 246 insertions(+), 22 deletions(-) create mode 100644 CONTRIBUTING-kr.md diff --git a/CONTRIBUTING-kr.md b/CONTRIBUTING-kr.md new file mode 100644 index 0000000000000..7787ce8a9971c --- /dev/null +++ b/CONTRIBUTING-kr.md @@ -0,0 +1,220 @@ +_다른 언어로 보기: [Français](CONTRIBUTING-fr.md), [Español](CONTRIBUTING-es.md), [简体中文](CONTRIBUTING-zh.md), [繁體中文](CONTRIBUTING-zh_TW.md), [فارسی](CONTRIBUTING-fa_IR.md), [Tiếng Việt](CONTRIBUTING-vn.md), [Русский](CONTRIBUTING-ru.md), [한국어](CONTRIBUTING-kr.md)._ + +## 기여자 라이선스 합의 + +기여함으로써 귀하는 이 리포지토리의 다음 [라이선스](https://github.com/EbookFoundation/free-programming-books/blob/master/LICENSE) 사항에 동의합니다. + +## 기여자 행동 강령 + +기여함으로써 귀하는 이 리포지토리의 다음 [행동강령](https://github.com/EbookFoundation/free-programming-books/blob/master/CODE_OF_CONDUCT.md) 사항에 동의합니다. + +## 요약 + +1. "책을 쉽게 다운로드할 수 있는 링크"는 늘 _무료_ 책에 대한 링크는 아닙니다. 무료 콘텐츠만 제공해주세요. 무료인지 확인하세요. 우리는 책을 얻기 위해 유효한 이메일 주소를 *요구*하는 페이지에 대한 링크를 허용하지 않지만, 책을 요청하는 목록에는 환영합니다. + 2.Git을 알 필요는 없습니다. _이 리포지토리에 아직 없는_ 흥미로운 것을 발견했다면 제안하시는 링크를 포함한 [이슈](https://github.com/EbookFoundation/free-programming-books/issues) 여십시오. + - Git 사용이 가능하시다면 저장소를 포크하고 풀 리퀘스트를 보내주세요. +2. 5가지 종류의 목록이 있습니다. 올바른 것을 선택하십시오.: + + - _책_ : PDF, HTML, ePub, gitbook.io 사이트, Git 레포지토리, 등. + - _강의_ : 코스는 책이 아닌 학습 자료입니다. [이런게 강의입니다](http://rogerdudler.github.io/git-guide/index.ko.html). + - _상호적인 튜터리얼_ : 사용자가 코드나 명령을 입력하고 결과를 평가할 수 있는 대화형 웹사이트 ("평가"는 "등급"을 의미하지 않습니다.). 예: [Try Haskell](http://tryhaskell.org), [Try Github](http://try.github.io). + - _팟캐스트와 스크린캐스트_ : 팟캐스트와 스크린캐스트. + - _문제 세트 및 경쟁 프로그래밍_ : + 다른 사용자와 결과를 비교하거나 코드 검토를 포함하거나 단순 또는 복잡한 문제를 해결하여 프로그래밍 기술을 평가할 수 있는 웹 사이트 또는 소프트웨어입니다. + +3. 아래 [가이드 지침](#guidelines)을 따르고 파일의 [마크다운 형식](#formatting)을 준수해야 합니다. + +4. GitHub Actions는 목록이 알파벳순으로 정렬되어 있고 형식 지정 규칙을 준수하는지 확인하기 위해 테스트를 실행합니다. 변경 사항이 테스트를 통과했는지 확인하십시오. + +### 가이드 지침 + +- 책이 무료인지 확인하십시오. 필요한 경우 다시 확인하십시오. 당신의 책이 무료라고 생각하는 이유에 대해 PR에 댓글을 달면 관리자에게 도움이 됩니다. +- google drive, dropbox, mega, scribd, issuu 또는 유사한 파일 업로드 플랫폼에서 호스팅되는 파일은 허용하지 않습니다. +- 알파벳 순서로 링크를 삽입하십시오. 잘못된 링크가 있는 경우 다시 수정하여 PR을 제출하세요. +- 가장 권위 있는 출처의 링크를 사용하십시오(작가의 웹사이트가 편집자의 웹사이트보다 우수하고 타사 웹사이트보다 우수함을 의미) +- 파일 호스팅 서비스 불가 (여기에는 Dropbox 및 Google Drive 링크가 포함되지만 이에 국한되지 않음) +- 동일한 도메인에 있고 동일한 콘텐츠를 제공하는 한 항상 `http` 링크보다 `https` 링크를 선호합니다. +- 루트 도메인에서 후행 슬래시를 제거합니다: `http://example.com/` 대신 `http://example.com` +- 항상 가장 짧은 링크를 선호: `http://example.com/dir/`가 `http://example.com/dir/index.html` 보다 좋습니다. +- URL 단축 링크 불가. +- 일반적으로 "버전" 링크보다 "현재" 링크를 선호합니다: `http://example.com/dir/book/current/`가 `http://example.com/dir/book/v1.0.0/index.html` 보다 좋습니다. +- 링크에 만료된 인증서/자체 서명된 인증서/다른 종류의 SSL 문제가 있는 경우: + 1. _교체 하십시오_: 가능하면 `http`로 대체합니다(모바일 장치에서는 예외를 수락하는 것이 복잡할 수 있기 때문에). + 2. _그대로 두십시오_: 사용 가능한 `http` 버전이 없다면 브라우저에 예외를 추가하거나 경고를 무시하여 `https`를 통해 링크에 계속 액세스할 수 있는 경우 그대로 두십시오. + 3. 아니라면 _제거하십시오_. +- 링크가 여러 형식으로 존재하는 경우 각 형식에 대한 메모와 함께 별도의 링크를 추가하십시오. +- 리소스가 인터넷의 다른 위치에 있는 경우: + - 가장 권위 있는 출처의 링크를 사용하십시오(작가의 웹사이트가 편집자의 웹사이트보다 낫다는 의미) + - 다른 에디션으로 연결되어 있고 이 에디션이 소장 가치가 있을 만큼 충분히 다르다고 판단되면 각 에디션에 대한 메모가 포함된 별도의 링크를 추가하십시오. ([Issue #2353](https://github.com/EbookFoundation/free-programming-books/issues/2353)를 확인하여 형식 관련 논의에 기여하십시오.) +- 더 큰 커밋보다 원자적 커밋(추가/삭제/수정에 의한 하나의 커밋)을 선호합니다. PR을 제출하기 전에 커밋을 스쿼시할 필요가 없습니다. (이 규칙은 관리자의 편의를 위한 것이기에 절대로 필수적이지는 않습니다.) +- 오래된 책일 경우 제목과 함께 발행일을 포함합니다. +- 적절한 경우 저자 이름을 포함합니다. "et al."을 사용하여 저자 목록을 줄일 수 있습니다. +- 책이 완성되지 않았고 아직 작업 중인 경우 [아래 설명(#in_process)]된 대로 "진행 중" 표기법을 추가하십시오. +- 다운로드가 활성화되기 전에 이메일 주소 또는 계정 설정이 요청된다면 괄호 안에 언어에 맞는 메모를 추가하십시오., 예: `(이메일 주소 *요청됨*, 필요 없음)` + +### 형식 + +- 모든 목록은 `.md` 파일입니다. [마크다운](https://guides.github.com/features/mastering-markdown/) 문법을 배워보세요. 간단합니다! +- 모든 목록은 인덱스로 시작합니다. 목록에 있는 모든 섹션과 하위 섹션을 나열하고 연결하는 것입니다. 알파벳 순서로 보관하십시오. +- 섹션에서 레벨 3 헤딩을 사용하고 있습니다. (`###`), 드리고 하위 섹션에서는 레벨 4 헤딩을 사용합니다 (`####`). + +이런 계획입니다: + +- `2`개의 빈 라인은 마지막 링크와 새 섹션 사이. +- `1`개의 빈 라인은 제목과 섹션의 첫 링크 사이. +- `0`개의 빈 라인은 두개의 링크 사이. +- `1`개의 빈 라인은 각 `.md` 파일에 끝에. + +예시: + + [...] + * [재밌는 책](http://example.com/example.html) + (빈 라인) + (빈 라인) + ### 타이틀 예시 + (빈 라인) + * [다른 재밌는 책](http://example.com/book.html) + * [또 다른 책](http://example.com/other.html) + +- `]` 와 `(` 사이에 띄어쓰기를 하지 마십시오: + +``` +BAD : * [다른 재밌는 책] (http://example.com/book.html) +GOOD: * [다른 재밌는 책](http://example.com/book.html) +``` + +- 저자를 포함한다면 `-` 를 사용하십시오 (단일 공백으로 둘러싸인 대시): + +``` +BAD : * [다른 재밌는 책](http://example.com/book.html)- 홍길동 +GOOD: * [다른 재밌는 책](http://example.com/book.html) - 홍길동 +``` + +- 링크와 해당 형식 사이에 공백 하나를 넣으십시오: + +``` +BAD : * [너무 재밌는 책](https://example.org/book.pdf)(PDF) +GOOD: * [너무 재밌는 책](https://example.org/book.pdf) (PDF) +``` + +- 저자는 형식보다 이전에 온다: + +``` +BAD : * [너무 재밌는 책](https://example.org/book.pdf)- (PDF) 홍진성 +GOOD: * [너무 재밌는 책](https://example.org/book.pdf) - 홍진성 (PDF) +``` + +- 여러 형식: + +``` +BAD : * [다른 재밌는 책](http://example.com/)- 홍길동 (HTML) +BAD : * [다른 재밌는 책](https://downloads.example.org/book.html)- 홍길동 (download site) +GOOD: * [다른 재밌는 책](http://example.com/) - 홍길동 (HTML) [(PDF, EPUB)](https://downloads.example.org/book.html) +``` + +- 오래된 책의 제목에 발행 연도 포함: + +``` +BAD : * [너무 재밌는 책](https://example.org/book.html) - 홍진성 - 1970 +GOOD: * [너무 재밌는 책 (1970)](https://example.org/book.html) - 홍진성 +``` + + + +- 진행 중인 책: + +``` +GOOD: * [곧 아주 재밌을 책](http://example.com/book2.html) - 홍길동 (HTML) (:construction: *진행중*) +``` + +### 노트 + +기본 사항은 비교적 간단하지만 나열한 리소스에는 매우 다양합니다. 다음은 이러한 다양성을 처리하는 방법에 대한 몇 가지 참고 사항입니다. + +#### 메타데이터 + +우리 목록은 제목, URL, 작성자, 플랫폼 및 액세스 정보와 같은 최소한의 메타데이터 집합을 제공합니다. + +##### 제목 + +- 발명된 제목이 없습니다. 리소스 자체에서 제목을 가져오려고 합니다. 기고자는 제목을 만들거나 피할 수 있는 경우 편집용으로 사용하지 말 것을 권고합니다. 오래된 작품은 예외입니다. 주로 역사적 관심이 있는 경우 제목에 괄호 안에 연도를 추가하면 사용자가 관심이 있는지 알 수 있습니다. +- ALLCAPS 타이틀이 없습니다. 일반적으로 제목 대소문자가 적절하지만 의심스러운 경우 출처의 대문자를 사용합니다. + +##### URL + +- 단축 URL은 허용되지 않습니다. +- URL에서 추적 코드를 제거해야 합니다. +- 국제 URL은 이스케이프 처리해야 합니다. 브라우저 막대는 일반적으로 이를 유니코드로 렌더링하지만 복사하여 붙여넣기를 사용하십시오. +- 보안(https) URL은 https가 구현된 비보안(http) URL보다 항상 선호됩니다. +- 우리는 나열된 리소스를 호스팅하지 않고 대신 다른 곳을 가리키는 웹페이지를 가리키는 URL을 좋아하지 않습니다. + +##### 제작자들 + +- 번역가를 포함하여 적절한 경우 무료 리소스의 제작자에게 공을 돌리고 싶습니다! +- 또는 번역된 작품은 원저자가 표시되어야 합니다. +- 크리에이터에 대한 링크는 허용하지 않습니다. +- 편집 또는 리믹스된 작품의 경우 "제작자"에 대한 설명이 필요할 수 있습니다. 예를 들어 "GoalKicker" 책은 "StackOverflow 문서에서 컴파일됨"으로 표시됩니다. + +##### 플랫폼 및 액세스 참고 사항 + +- 강의 또는 코스. 특히 강의 목록의 경우 플랫폼은 리소스 설명의 중요한 부분입니다. 코스 플랫폼마다 어포던스와 액세스 모델이 다르기 때문입니다. 일반적으로 등록이 필요한 책은 나열하지 않지만 많은 코스 플랫폼에는 일종의 계정 없이는 작동하지 않는 어포던스가 있습니다. 코스 플랫폼의 예에는 Coursera, EdX, Udacity 및 Udemy가 있습니다. 과정이 플랫폼에 종속되는 경우 플랫폼 이름은 괄호 안에 나열되어야 합니다. +- 유튜브. YouTube 재생 목록으로 구성된 많은 과정이 있습니다. YouTube를 플랫폼으로 나열하지 않고 종종 하위 플랫폼인 Youtube 제작자를 나열하려고 합니다. +- 유튜브 동영상. 우리는 일반적으로 1시간 이상 길이가 코스나 튜토리얼처럼 구성되지 않는 한 개별 YouTube 동영상에 링크하지 않습니다. +- 린펍. Leanpub은 다양한 액세스 모델로 책을 호스팅합니다. 때로는 등록 없이도 책을 읽을 수 있습니다. 때때로 책은 무료 액세스를 위해 Leanpub 계정이 필요합니다. 책의 품질과 Leanpub 액세스 모델의 혼합 및 유동성을 고려할 때 액세스 메모 *(Leanpub 계정 또는 유효한 이메일 요청)*과 함께 후자의 목록을 허용합니다. + +#### 장르 + +리소스가 속한 목록을 결정하는 첫 번째 규칙은 리소스가 자체적으로 설명하는 방식을 확인하는 것입니다. 그것이 스스로를 책이라고 부른다면 아마도 그것은 책일 것입니다. + +##### 포함하지 않은 장르 + +인터넷은 방대하기 때문에 목록에 포함하지 않습니다: + +- 블로그 +- 블로그 포스트 +- 아티클 +- 웹사이트 (우리가 나열하는 많은 항목을 호스팅하는 항목을 제외하고.) +- 코스나 스크린캐스트가 아닌 비디오. +- 책의 장 +- 책의 티저 샘플 +- IRC 또는 텔레그램 채널 +- 슬랙스 또는 메일링 리스트 + +우리의 경쟁 프로그램 목록은 이러한 제외에 대해 엄격하지 않습니다. 리포지토리의 범위는 커뮤니티에서 결정합니다. 범위에 대한 변경이나 추가를 제안하려면 이슈를 사용하여 제안하십시오. + +##### 책 vs. 기타 리소스 + +우리는 책에 그렇게 까다롭지 않습니다. 다음은 리소스가 책임을 나타내는 몇 가지 속성입니다: + +- ISBN(International Standard Book Number)이 있습니다. +- 목차가 있습니다. +- 다운로드 버전, 특히 ePub 제공 +- 에디션이 있습니다. +- 인터랙티브한 콘텐츠나 동영상에 의존하지 않습니다. +- 주제를 포괄적으로 다루려고 합니다. +- 자체적으로 포함되어 있습니다. + +이러한 속성이 없는 많은 책이 나열되어 있습니다. 컨텍스트에 따라 달라질 수 있습니다. + +##### 책 vs. 강의 + +때때로 이것들은 구별하기 어려울 수 있습니다! + +코스에는 종종 관련 교과서가 있으며, 이는 우리의 도서 목록에 나열됩니다. 코스에는 강의, 연습, 테스트, 메모 또는 기타 교훈적인 보조 자료가 있습니다. 하나의 강의나 비디오 자체는 강의가 아닙니다. 파워포인트는 강의가 아닙니다. + +##### 상호적인 튜터리얼 vs. 기타 리소스 + +인쇄하여 본질을 유지할 수 있다면 대화형 자습서가 아닙니다. + +### 자동화 + +- 서식 규칙 적용은 [fpb-lint](https://github.com/vhf/free-programming-books-lint)를 사용하여 [GitHub Actions](https://github.com/features/actions)를 통해 자동화됩니다. [.github/workflows/fpb-lint.yml](.github/workflows/fpb-lint.yml) 참조) +- URL 유효성 검사는 [awesome_bot](https://github.com/dkhamsing/awesome_bot)을 사용합니다. +- URL 유효성 검사를 트리거하려면 `check_urls=file_to_check`가 포함된 커밋 메시지가 포함된 커밋을 푸시합니다.: + +``` +check_urls=free-programming-books.md free-programming-books-en.md +``` + +- 각 항목을 구분하는 단일 공백을 사용하여 검사할 파일을 두 개 이상 지정할 수 있습니다. +- 파일을 2개 이상 지정할 경우, 마지막으로 확인한 파일의 결과를 기준으로 빌드 결과가 결정됩니다. 이로 인해 녹색 빌드를 통과할 수 있으므로 "모든 검사 표시" -> "세부 정보"를 클릭하여 풀 요청이 끝날 때 빌드 로그를 검사해야 합니다. diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 2f06fa7f7ebdf..64999934c82b1 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,46 +1,50 @@ -*Read this in other languages: [Deutsch](CONTRIBUTING-de.md), [Français](CONTRIBUTING-fr.md), [Filipino](CONTRIBUTING-fil.md), [Español](CONTRIBUTING-es.md), [Indonesia](CONTRIBUTING-id.md),[简体中文](CONTRIBUTING-zh.md), [繁體中文](CONTRIBUTING-zh_TW.md), [Português (BR)](CONTRIBUTING-pt_BR.md), [فارسی](CONTRIBUTING-fa_IR.md), [Tiếng Việt](CONTRIBUTING-vn.md), [Русский](CONTRIBUTING-ru.md).* +_Read this in other languages: [Deutsch](CONTRIBUTING-de.md), [Français](CONTRIBUTING-fr.md), [Filipino](CONTRIBUTING-fil.md), [Español](CONTRIBUTING-es.md), [Indonesia](CONTRIBUTING-id.md),[简体中文](CONTRIBUTING-zh.md), [繁體中文](CONTRIBUTING-zh_TW.md), [Português (BR)](CONTRIBUTING-pt_BR.md), [فارسی](CONTRIBUTING-fa_IR.md), [Tiếng Việt](CONTRIBUTING-vn.md), [Русский](CONTRIBUTING-ru.md)._ ## Contributor License Agreement + By contributing you agree to the [LICENSE](https://github.com/EbookFoundation/free-programming-books/blob/master/LICENSE) of this repository. ## Contributor Code of Conduct + By contributing you agree to respect the [Code of Conduct](https://github.com/EbookFoundation/free-programming-books/blob/master/CODE_OF_CONDUCT.md) of this repository. ## In a nutshell -1. "A link to easily download a book" is not always a link to a *free* book. Please only contribute free content. Make sure it's free. We do not accept links to pages that *require* working email addresses to obtain books, but we welcome listings that request them. -2. You don't have to know Git: if you found something of interest which is *not already in this repo*, please open an [Issue](https://github.com/EbookFoundation/free-programming-books/issues) with your links propositions. - - If you know Git, please Fork the repo and send pull requests. + +1. "A link to easily download a book" is not always a link to a _free_ book. Please only contribute free content. Make sure it's free. We do not accept links to pages that _require_ working email addresses to obtain books, but we welcome listings that request them. +2. You don't have to know Git: if you found something of interest which is _not already in this repo_, please open an [Issue](https://github.com/EbookFoundation/free-programming-books/issues) with your links propositions. + - If you know Git, please Fork the repo and send pull requests. 3. We have 5 kinds of lists. Choose the right one: - - *Books* : PDF, HTML, ePub, a gitbook.io based site, a Git repo, etc. - - *Courses* : A course is a learning material which is not a book. [This is a course](http://ocw.mit.edu/courses/electrical-engineering-and-computer-science/6-006-introduction-to-algorithms-fall-2011/). - - *Interactive Tutorials* : An interactive website which lets the user type code or commands and evaluates the result (by "evaluate" we don't mean "grade"). e.g.: [Try Haskell](http://tryhaskell.org), [Try Github](http://try.github.io). - - *Podcasts and Screencasts* : Podcasts and screencasts. - - *Problem Sets & Competitive Programming* : A website or software which lets you assess your programming skills by solving simple or complex problems, with or without code review, with or without comparing the results with other users. + - _Books_ : PDF, HTML, ePub, a gitbook.io based site, a Git repo, etc. + - _Courses_ : A course is a learning material which is not a book. [This is a course](http://ocw.mit.edu/courses/electrical-engineering-and-computer-science/6-006-introduction-to-algorithms-fall-2011/). + - _Interactive Tutorials_ : An interactive website which lets the user type code or commands and evaluates the result (by "evaluate" we don't mean "grade"). e.g.: [Try Haskell](http://tryhaskell.org), [Try Github](http://try.github.io). + - _Podcasts and Screencasts_ : Podcasts and screencasts. + - _Problem Sets & Competitive Programming_ : A website or software which lets you assess your programming skills by solving simple or complex problems, with or without code review, with or without comparing the results with other users. 4. Make sure to follow the [guidelines below](#guidelines) and respect the [Markdown formatting](#formatting) of the files. 5. GitHub Actions will run tests to make sure your lists are alphabetized and formatting rules are followed. Be sure to check that your changes pass the tests. ### Guidelines + - make sure a book is free. Double-check if needed. It helps the admins if you comment in the PR as to why you think the book is free. - we don't accept files hosted on Google Drive, Dropbox, Mega, Scribd, Issuu and other similar file upload platforms - insert your links in alphabetical order. If you see a misplaced link, please reorder it and submit a PR - use the link with the most authoritative source (meaning the author's website is better than the editor's website, which is better than a third party website) - + no file hosting services (this includes (but is not limited to) Dropbox and Google Drive links) + - no file hosting services (this includes (but is not limited to) Dropbox and Google Drive links) - always prefer a `https` link over a `http` one -- as long as they are on the same domain and serve the same content - on root domains, strip the trailing slash: `http://example.com` instead of `http://example.com/` - always prefer the shortest link: `http://example.com/dir/` is better than `http://example.com/dir/index.html` - + no URL shortener links + - no URL shortener links - usually prefer the "current" link over the "version" one: `http://example.com/dir/book/current/` is better than `http://example.com/dir/book/v1.0.0/index.html` - if a link has an expired certificate/self-signed certificate/SSL issue of any other kind: - 1. *replace it* with its `http` counterpart if possible (because accepting exceptions can be complicated on mobile devices). - 2. *leave it* if no `http` version is available but the link is still accessible through `https` by adding an exception to the browser or ignoring the warning. - 3. *remove it* otherwise. + 1. _replace it_ with its `http` counterpart if possible (because accepting exceptions can be complicated on mobile devices). + 2. _leave it_ if no `http` version is available but the link is still accessible through `https` by adding an exception to the browser or ignoring the warning. + 3. _remove it_ otherwise. - if a link exists in multiple format, add a separate link with a note about each format - if a resource exists at different places on the Internet - + use the link with the most authoritative source (meaning author's website is better than editor's website is better than third party website) - + if they link to different editions, and you judge these editions are different enough to be worth keeping them, add a separate link with a note about each edition (see [Issue #2353](https://github.com/EbookFoundation/free-programming-books/issues/2353) to contribute to the discussion on formatting.) + - use the link with the most authoritative source (meaning author's website is better than editor's website is better than third party website) + - if they link to different editions and you judge these editions are different enough to be worth keeping them, add a separate link with a note about each edition (see [Issue #2353](https://github.com/EbookFoundation/free-programming-books/issues/2353) to contribute to the discussion on formatting.) - prefer atomic commits (one commit by addition/deletion/modification) over bigger commits. No need to squash your commits before submitting a PR. (We will never enforce this rule as it's just a matter of convenience for the maintainers) - if the book is older, include the publication date with the title. - include the author name or names where appropriate. You can shorten author lists with "et al." @@ -49,11 +53,13 @@ By contributing you agree to respect the [Code of Conduct](https://github.com/Eb - if an email address or account setup is requested before download is enabled, add language-appropriate notes in parentheses, e.g.: `(email address *requested*, not required)` ### Formatting + - All lists are `.md` files. Try to learn [Markdown](https://guides.github.com/features/mastering-markdown/) syntax. It's simple! - All the lists start with an Index. The idea is to list and link all sections and subsections there. Keep it in alphabetical order. - Sections are using level 3 headings (`###`), and subsections are level 4 headings (`####`). The idea is to have: + - `2` empty lines between last link and new section. - `1` empty line between heading & first link of its section. - `0` empty line between two links. @@ -77,7 +83,7 @@ BAD : * [Another Awesome Book] (http://example.com/book.html) GOOD: * [Another Awesome Book](http://example.com/book.html) ``` -- If you include the author, use ` - ` (a dash surrounded by single spaces): +- If you include the author, use `-` (a dash surrounded by single spaces): ``` BAD : * [Another Awesome Book](http://example.com/book.html)- John Doe @@ -114,6 +120,7 @@ GOOD: * [A Very Awesome Book (1970)](https://example.org/book.html) - Jane Roe ``` + - In-process books: ``` @@ -121,6 +128,7 @@ GOOD: * [Will Be An Awesome Book Soon](http://example.com/book2.html) - John Doe ``` + - Archived link: ``` @@ -160,7 +168,7 @@ Our lists provide a minimal set of metadata: titles, URLs, creators, platforms, - Courses. Especially for our course lists, the platform is an important part of the resource description. This is because course platforms have different affordances and access models. While we usually won't list a book that requires a registration, many course platforms have affordances that don't work without some sort of account. Example course platforms include Coursera, EdX, Udacity, and Udemy. When a course depends on a platform, the platform name should be listed in parentheses. - YouTube. We have many courses which consist of YouTube playlists. We do not list Youtube as a platform, we try to list the Youtube creator, which is often a sub-platform. - YouTube videos. We usually don't link to individual YouTube videos unless they are more than an hour long and are structured like a course or a tutorial. -- Leanpub. Leanpub hosts books with a variety of access models. Sometimes a book can be read without registration; sometimes a book requires a Leanpub account for free access. Given quality of the books and the mixture and fluidity of Leanpub access models, we permit listing of the latter with the access note *(Leanpub account or valid email requested)* +- Leanpub. Leanpub hosts books with a variety of access models. Sometimes a book can be read without registration; sometimes a book requires a Leanpub account for free access. Given quality of the books and the mixture and fluidity of Leanpub access models, we permit listing of the latter with the access note _(Leanpub account or valid email requested)_ #### Genres @@ -182,7 +190,6 @@ Because the Internet is vast, we don't include in our lists: Our competitive programming lists are not as strict about these exclusions. The scope of the repo is determined by the community; if you want to suggest a change or addition to the scope, please use an issue to make the suggestion. - ##### Books vs. Other Stuff We're not that fussy about book-ness. Here are some attributes that signify that a resource is a book: @@ -197,19 +204,16 @@ We're not that fussy about book-ness. Here are some attributes that signify that There are lots of books that we list that don't have these attributes; it can depend on context. - ##### Books vs. Courses Sometimes these can be hard to distinguish! Courses often have associated textbooks, which we would list in our books lists. Courses have lectures, exercises, tests, notes or other didactic aids. A single lecture or video by itself is not a course. A powerpoint is not a course. - ##### Interactive Tutorials vs. Other stuff If you can print it out and retain its essence, it's not an Interactive Tutorial. - ### Automation - Formatting rules enforcement is automated via [GitHub Actions](https://github.com/features/actions) using [fpb-lint](https://github.com/vhf/free-programming-books-lint) (see [.github/workflows/fpb-lint.yml](.github/workflows/fpb-lint.yml)) From 5155df558d924f70aad9f79a262cc19e8f970a02 Mon Sep 17 00:00:00 2001 From: Wonjang Son Date: Sun, 3 Oct 2021 18:56:27 +0200 Subject: [PATCH 03/16] Implemented HOWTO korean translation --- HOWTO-ko.md | 13 ++++++------- HOWTO.md | 13 ++++++------- 2 files changed, 12 insertions(+), 14 deletions(-) diff --git a/HOWTO-ko.md b/HOWTO-ko.md index f6c52a32eef66..f07be9aab075f 100644 --- a/HOWTO-ko.md +++ b/HOWTO-ko.md @@ -2,13 +2,12 @@ Free-Programming-Books 에 오신 것을 환영합니다! 우리는 Github 에 첫 Pull-request 를 분들을 포함한 새로운 기여자들을 환영합니다. 다음 리소스들은 당신에게 도움이 될 수 있습니다: -* [About Pull Requests](https://help.github.com/articles/about-pull-requests/) -* [Creating a pull request](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request) -* [Github Hello World](https://guides.github.com/activities/hello-world/) -* [Youtube - Github Tutorial For Beginners](https://www.youtube.com/watch?v=0fKg7e37bQE) -* [Youtube - How To Fork A GitHub Repo and Submit A Pull Request](https://www.youtube.com/watch?v=G1I3HF4YWEw) -* [Youtube - Markdown Crash Course](https://www.youtube.com/watch?v=HUBNt18RFbo) - +- [About Pull Requests](https://help.github.com/articles/about-pull-requests/) +- [Creating a pull request](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request) +- [Github Hello World](https://guides.github.com/activities/hello-world/) +- [Youtube - Github Tutorial For Beginners](https://www.youtube.com/watch?v=0fKg7e37bQE) +- [Youtube - How To Fork A GitHub Repo and Submit A Pull Request](https://www.youtube.com/watch?v=G1I3HF4YWEw) +- [Youtube - Markdown Crash Course](https://www.youtube.com/watch?v=HUBNt18RFbo) 주저하지 말고 질문하세요. 모든 기여자들 역시 첫 Pull-request 로 시작했습니다. 당신은 우리의 1000번째가 될 수도 있어요! diff --git a/HOWTO.md b/HOWTO.md index c1bdd69ced9ac..bc2fb6de07ed3 100644 --- a/HOWTO.md +++ b/HOWTO.md @@ -2,13 +2,12 @@ Read this in other languages: [Français](HOWTO-fr.md), [Español](HOWTO-es.md), Welcome to Free-Programming-Books! We welcome new contributors; even those making their very first pull request on Github. If you're one of those, here are some resources that might help: -* [About Pull Requests](https://help.github.com/articles/about-pull-requests/) -* [Creating a pull request](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request) -* [Github Hello World](https://guides.github.com/activities/hello-world/) -* [Youtube - Github Tutorial For Beginners](https://www.youtube.com/watch?v=0fKg7e37bQE) -* [Youtube - How To Fork A GitHub Repo and Submit A Pull Request](https://www.youtube.com/watch?v=G1I3HF4YWEw) -* [Youtube - Markdown Crash Course](https://www.youtube.com/watch?v=HUBNt18RFbo) - +- [About Pull Requests](https://help.github.com/articles/about-pull-requests/) +- [Creating a pull request](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request) +- [Github Hello World](https://guides.github.com/activities/hello-world/) +- [Youtube - Github Tutorial For Beginners](https://www.youtube.com/watch?v=0fKg7e37bQE) +- [Youtube - How To Fork A GitHub Repo and Submit A Pull Request](https://www.youtube.com/watch?v=G1I3HF4YWEw) +- [Youtube - Markdown Crash Course](https://www.youtube.com/watch?v=HUBNt18RFbo) Don't hesitate to ask questions; every contributor started with a first PR. You could be our thousandth! From e8702cf668df693645673ddbab80db47b9c3dc48 Mon Sep 17 00:00:00 2001 From: Wonjang Son Date: Tue, 5 Oct 2021 14:12:23 +0200 Subject: [PATCH 04/16] Added English link --- CONTRIBUTING-kr.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CONTRIBUTING-kr.md b/CONTRIBUTING-kr.md index 7787ce8a9971c..239987f184b14 100644 --- a/CONTRIBUTING-kr.md +++ b/CONTRIBUTING-kr.md @@ -1,4 +1,4 @@ -_다른 언어로 보기: [Français](CONTRIBUTING-fr.md), [Español](CONTRIBUTING-es.md), [简体中文](CONTRIBUTING-zh.md), [繁體中文](CONTRIBUTING-zh_TW.md), [فارسی](CONTRIBUTING-fa_IR.md), [Tiếng Việt](CONTRIBUTING-vn.md), [Русский](CONTRIBUTING-ru.md), [한국어](CONTRIBUTING-kr.md)._ +_다른 언어로 보기: [Français](CONTRIBUTING-fr.md), [English](CONTRIBUTING.md), [Español](CONTRIBUTING-es.md), [简体中文](CONTRIBUTING-zh.md), [繁體中文](CONTRIBUTING-zh_TW.md), [فارسی](CONTRIBUTING-fa_IR.md), [Tiếng Việt](CONTRIBUTING-vn.md), [Русский](CONTRIBUTING-ru.md), [한국어](CONTRIBUTING-kr.md)._ ## 기여자 라이선스 합의 From 950adae02bd330ed3e4d29b18228ce7992672294 Mon Sep 17 00:00:00 2001 From: Wonjang Son Date: Tue, 5 Oct 2021 14:33:13 +0200 Subject: [PATCH 05/16] Reverted MD syntax formatting --- CONTRIBUTING-kr.md | 22 +++++++++++----------- CONTRIBUTING.md | 4 ++-- HOWTO-ko.md | 13 +++++++------ HOWTO.md | 13 +++++++------ 4 files changed, 27 insertions(+), 25 deletions(-) diff --git a/CONTRIBUTING-kr.md b/CONTRIBUTING-kr.md index 239987f184b14..4b16d9a1b9427 100644 --- a/CONTRIBUTING-kr.md +++ b/CONTRIBUTING-kr.md @@ -1,4 +1,4 @@ -_다른 언어로 보기: [Français](CONTRIBUTING-fr.md), [English](CONTRIBUTING.md), [Español](CONTRIBUTING-es.md), [简体中文](CONTRIBUTING-zh.md), [繁體中文](CONTRIBUTING-zh_TW.md), [فارسی](CONTRIBUTING-fa_IR.md), [Tiếng Việt](CONTRIBUTING-vn.md), [Русский](CONTRIBUTING-ru.md), [한국어](CONTRIBUTING-kr.md)._ +*다른 언어로 보기: [Français](CONTRIBUTING-fr.md), [English](CONTRIBUTING.md), [Español](CONTRIBUTING-es.md), [简体中文](CONTRIBUTING-zh.md), [繁體中文](CONTRIBUTING-zh_TW.md), [فارسی](CONTRIBUTING-fa_IR.md), [Tiếng Việt](CONTRIBUTING-vn.md), [Русский](CONTRIBUTING-ru.md), [한국어](CONTRIBUTING-kr.md).* ## 기여자 라이선스 합의 @@ -10,16 +10,16 @@ _다른 언어로 보기: [Français](CONTRIBUTING-fr.md), [English](CONTRIBUTIN ## 요약 -1. "책을 쉽게 다운로드할 수 있는 링크"는 늘 _무료_ 책에 대한 링크는 아닙니다. 무료 콘텐츠만 제공해주세요. 무료인지 확인하세요. 우리는 책을 얻기 위해 유효한 이메일 주소를 *요구*하는 페이지에 대한 링크를 허용하지 않지만, 책을 요청하는 목록에는 환영합니다. - 2.Git을 알 필요는 없습니다. _이 리포지토리에 아직 없는_ 흥미로운 것을 발견했다면 제안하시는 링크를 포함한 [이슈](https://github.com/EbookFoundation/free-programming-books/issues) 여십시오. +1. "책을 쉽게 다운로드할 수 있는 링크"는 늘 *무료* 책에 대한 링크는 아닙니다. 무료 콘텐츠만 제공해주세요. 무료인지 확인하세요. 우리는 책을 얻기 위해 유효한 이메일 주소를 *요구*하는 페이지에 대한 링크를 허용하지 않지만, 책을 요청하는 목록에는 환영합니다. + 2.Git을 알 필요는 없습니다. *이 리포지토리에 아직 없는* 흥미로운 것을 발견했다면 제안하시는 링크를 포함한 [이슈](https://github.com/EbookFoundation/free-programming-books/issues) 여십시오. - Git 사용이 가능하시다면 저장소를 포크하고 풀 리퀘스트를 보내주세요. 2. 5가지 종류의 목록이 있습니다. 올바른 것을 선택하십시오.: - - _책_ : PDF, HTML, ePub, gitbook.io 사이트, Git 레포지토리, 등. - - _강의_ : 코스는 책이 아닌 학습 자료입니다. [이런게 강의입니다](http://rogerdudler.github.io/git-guide/index.ko.html). - - _상호적인 튜터리얼_ : 사용자가 코드나 명령을 입력하고 결과를 평가할 수 있는 대화형 웹사이트 ("평가"는 "등급"을 의미하지 않습니다.). 예: [Try Haskell](http://tryhaskell.org), [Try Github](http://try.github.io). - - _팟캐스트와 스크린캐스트_ : 팟캐스트와 스크린캐스트. - - _문제 세트 및 경쟁 프로그래밍_ : + - *책* : PDF, HTML, ePub, gitbook.io 사이트, Git 레포지토리, 등. + - *강의* : 코스는 책이 아닌 학습 자료입니다. [이런게 강의입니다](http://rogerdudler.github.io/git-guide/index.ko.html). + - *상호적인 튜터리얼* : 사용자가 코드나 명령을 입력하고 결과를 평가할 수 있는 대화형 웹사이트 ("평가"는 "등급"을 의미하지 않습니다.). 예: [Try Haskell](http://tryhaskell.org), [Try Github](http://try.github.io). + - *팟캐스트와 스크린캐스트* : 팟캐스트와 스크린캐스트. + - *문제 세트 및 경쟁 프로그래밍* : 다른 사용자와 결과를 비교하거나 코드 검토를 포함하거나 단순 또는 복잡한 문제를 해결하여 프로그래밍 기술을 평가할 수 있는 웹 사이트 또는 소프트웨어입니다. 3. 아래 [가이드 지침](#guidelines)을 따르고 파일의 [마크다운 형식](#formatting)을 준수해야 합니다. @@ -39,9 +39,9 @@ _다른 언어로 보기: [Français](CONTRIBUTING-fr.md), [English](CONTRIBUTIN - URL 단축 링크 불가. - 일반적으로 "버전" 링크보다 "현재" 링크를 선호합니다: `http://example.com/dir/book/current/`가 `http://example.com/dir/book/v1.0.0/index.html` 보다 좋습니다. - 링크에 만료된 인증서/자체 서명된 인증서/다른 종류의 SSL 문제가 있는 경우: - 1. _교체 하십시오_: 가능하면 `http`로 대체합니다(모바일 장치에서는 예외를 수락하는 것이 복잡할 수 있기 때문에). - 2. _그대로 두십시오_: 사용 가능한 `http` 버전이 없다면 브라우저에 예외를 추가하거나 경고를 무시하여 `https`를 통해 링크에 계속 액세스할 수 있는 경우 그대로 두십시오. - 3. 아니라면 _제거하십시오_. + 1. *교체 하십시오*: 가능하면 `http`로 대체합니다(모바일 장치에서는 예외를 수락하는 것이 복잡할 수 있기 때문에). + 2. *그대로 두십시오*: 사용 가능한 `http` 버전이 없다면 브라우저에 예외를 추가하거나 경고를 무시하여 `https`를 통해 링크에 계속 액세스할 수 있는 경우 그대로 두십시오. + 3. 아니라면 *제거하십시오*. - 링크가 여러 형식으로 존재하는 경우 각 형식에 대한 메모와 함께 별도의 링크를 추가하십시오. - 리소스가 인터넷의 다른 위치에 있는 경우: - 가장 권위 있는 출처의 링크를 사용하십시오(작가의 웹사이트가 편집자의 웹사이트보다 낫다는 의미) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 64999934c82b1..db29143e000c5 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -19,7 +19,7 @@ By contributing you agree to respect the [Code of Conduct](https://github.com/Eb - _Courses_ : A course is a learning material which is not a book. [This is a course](http://ocw.mit.edu/courses/electrical-engineering-and-computer-science/6-006-introduction-to-algorithms-fall-2011/). - _Interactive Tutorials_ : An interactive website which lets the user type code or commands and evaluates the result (by "evaluate" we don't mean "grade"). e.g.: [Try Haskell](http://tryhaskell.org), [Try Github](http://try.github.io). - _Podcasts and Screencasts_ : Podcasts and screencasts. - - _Problem Sets & Competitive Programming_ : A website or software which lets you assess your programming skills by solving simple or complex problems, with or without code review, with or without comparing the results with other users. + - _Problem Sets & Competitive Programming_ : A website or software which lets you assess your programming skills by solving simple or complex problems, with or without code review, with or without comparing the results with other users 4. Make sure to follow the [guidelines below](#guidelines) and respect the [Markdown formatting](#formatting) of the files. @@ -44,7 +44,7 @@ By contributing you agree to respect the [Code of Conduct](https://github.com/Eb - if a link exists in multiple format, add a separate link with a note about each format - if a resource exists at different places on the Internet - use the link with the most authoritative source (meaning author's website is better than editor's website is better than third party website) - - if they link to different editions and you judge these editions are different enough to be worth keeping them, add a separate link with a note about each edition (see [Issue #2353](https://github.com/EbookFoundation/free-programming-books/issues/2353) to contribute to the discussion on formatting.) + - if they link to different editions, and you judge these editions are different enough to be worth keeping them, add a separate link with a note about each edition (see [Issue #2353](https://github.com/EbookFoundation/free-programming-books/issues/2353) to contribute to the discussion on formatting.) - prefer atomic commits (one commit by addition/deletion/modification) over bigger commits. No need to squash your commits before submitting a PR. (We will never enforce this rule as it's just a matter of convenience for the maintainers) - if the book is older, include the publication date with the title. - include the author name or names where appropriate. You can shorten author lists with "et al." diff --git a/HOWTO-ko.md b/HOWTO-ko.md index f07be9aab075f..f6c52a32eef66 100644 --- a/HOWTO-ko.md +++ b/HOWTO-ko.md @@ -2,12 +2,13 @@ Free-Programming-Books 에 오신 것을 환영합니다! 우리는 Github 에 첫 Pull-request 를 분들을 포함한 새로운 기여자들을 환영합니다. 다음 리소스들은 당신에게 도움이 될 수 있습니다: -- [About Pull Requests](https://help.github.com/articles/about-pull-requests/) -- [Creating a pull request](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request) -- [Github Hello World](https://guides.github.com/activities/hello-world/) -- [Youtube - Github Tutorial For Beginners](https://www.youtube.com/watch?v=0fKg7e37bQE) -- [Youtube - How To Fork A GitHub Repo and Submit A Pull Request](https://www.youtube.com/watch?v=G1I3HF4YWEw) -- [Youtube - Markdown Crash Course](https://www.youtube.com/watch?v=HUBNt18RFbo) +* [About Pull Requests](https://help.github.com/articles/about-pull-requests/) +* [Creating a pull request](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request) +* [Github Hello World](https://guides.github.com/activities/hello-world/) +* [Youtube - Github Tutorial For Beginners](https://www.youtube.com/watch?v=0fKg7e37bQE) +* [Youtube - How To Fork A GitHub Repo and Submit A Pull Request](https://www.youtube.com/watch?v=G1I3HF4YWEw) +* [Youtube - Markdown Crash Course](https://www.youtube.com/watch?v=HUBNt18RFbo) + 주저하지 말고 질문하세요. 모든 기여자들 역시 첫 Pull-request 로 시작했습니다. 당신은 우리의 1000번째가 될 수도 있어요! diff --git a/HOWTO.md b/HOWTO.md index bc2fb6de07ed3..c1bdd69ced9ac 100644 --- a/HOWTO.md +++ b/HOWTO.md @@ -2,12 +2,13 @@ Read this in other languages: [Français](HOWTO-fr.md), [Español](HOWTO-es.md), Welcome to Free-Programming-Books! We welcome new contributors; even those making their very first pull request on Github. If you're one of those, here are some resources that might help: -- [About Pull Requests](https://help.github.com/articles/about-pull-requests/) -- [Creating a pull request](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request) -- [Github Hello World](https://guides.github.com/activities/hello-world/) -- [Youtube - Github Tutorial For Beginners](https://www.youtube.com/watch?v=0fKg7e37bQE) -- [Youtube - How To Fork A GitHub Repo and Submit A Pull Request](https://www.youtube.com/watch?v=G1I3HF4YWEw) -- [Youtube - Markdown Crash Course](https://www.youtube.com/watch?v=HUBNt18RFbo) +* [About Pull Requests](https://help.github.com/articles/about-pull-requests/) +* [Creating a pull request](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request) +* [Github Hello World](https://guides.github.com/activities/hello-world/) +* [Youtube - Github Tutorial For Beginners](https://www.youtube.com/watch?v=0fKg7e37bQE) +* [Youtube - How To Fork A GitHub Repo and Submit A Pull Request](https://www.youtube.com/watch?v=G1I3HF4YWEw) +* [Youtube - Markdown Crash Course](https://www.youtube.com/watch?v=HUBNt18RFbo) + Don't hesitate to ask questions; every contributor started with a first PR. You could be our thousandth! From 2e0aec6596e27b5d307e2c51ee8b8810130cb7ec Mon Sep 17 00:00:00 2001 From: Wonjang Son Date: Tue, 5 Oct 2021 14:40:19 +0200 Subject: [PATCH 06/16] Revert MD syntax --- CODE_OF_CONDUCT-ko.md | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/CODE_OF_CONDUCT-ko.md b/CODE_OF_CONDUCT-ko.md index a5c3bb61caa63..d07e5d4e93c5c 100644 --- a/CODE_OF_CONDUCT-ko.md +++ b/CODE_OF_CONDUCT-ko.md @@ -4,25 +4,25 @@ 우리는 이슈리포팅, 기능 요청, 문서 업데이트, Pull request 또는 Patch 제출 및 기타 활동을 통해 기여하는 모든 사람들을 존중할 것을 약속합니다. -우리는 경험, 성별, 성 정체성 및 표현, 성적 지향, 장애, 외모, 신체 크기, 인종, 나이, 종교 -또는 국적에 관계없이 이 프로젝트에 참여하는 것을 모든 사람에게 +우리는 경험, 성별, 성 정체성 및 표현, 성적 지향, 장애, 외모, 신체 크기, 인종, 나이, 종교 +또는 국적에 관계없이 이 프로젝트에 참여하는 것을 모든 사람에게 괴롭힘 없는 경험으로 만들기 위해 최선을 다하고 있습니다. 허용할 수 없는 행동의 예는 다음과 같다. -- 성적인 언어와 이미지 사용 -- 인신공격 -- 트롤링 또는 모욕/모독성 댓글 -- 공개적이거나 개인적인 괴롭힘 -- 동의없는 집주소 또는 전자주소 등의 개인 정보의 공개 -- 부적절한 것으로 간주될 수 있는 다른 행위 +* 성적인 언어와 이미지 사용 +* 인신공격 +* 트롤링 또는 모욕/모독성 댓글 +* 공개적이거나 개인적인 괴롭힘 +* 동의없는 집주소 또는 전자주소 등의 개인 정보의 공개 +* 부적절한 것으로 간주될 수 있는 다른 행위 프로젝트 유지자는 이 행동 강령을 따르지 않은 댓글, 커밋, 코드, 위키 편집, 이슈와 그 외 다른 기여를 삭제, 수정 또는 거부할 권리와 책임이 있습니다. 또한, 부적당하거나 험악하거나 공격적이거나 해롭다고 생각하는 다른 행동을 한 기여자를 일시적 또는 영구적으로 퇴장시킬 수 있습니다. 이 행동 강령을 채택함으로써 프로젝트 메인테이너들은 이 프로젝트 관리의 모든 측면에 공정하고 -일관되게 이러한 원칙을 적용하기로 약속합니다. 행동 강령을 따르지 않는 프로젝트 메인테이너는 +일관되게 이러한 원칙을 적용하기로 약속합니다. 행동 강령을 따르지 않는 프로젝트 메인테이너는 프로젝트 팀에서 영구히 제명 될 수 있습니다. 이 행동 강령은 개인 프로젝트 또는 해당 커뮤니티를 대표하는 프로젝트 스페이스나 퍼블릭 스페이스 @@ -30,9 +30,9 @@ 모욕적이거나 괴롭힘 또는 기타 용납할 수 없는 행동의 사례는 프로젝트 관리자 victorfelder@gmail.com 에게 연락하여 보고 할 수 있습니다. 모든 불만사항은 검토하고 조사한 뒤 상황에 따라 필요하고 적절하다고 생각되는 -응답을 할 것 입니다. 관리자는 사건의 보고자와 관련한 비밀을 유지할 의무가 있습니다. +응답을 할 것 입니다. 관리자는 사건의 보고자와 관련한 비밀을 유지할 의무가 있습니다. -이 행동 강령은 [기여자 규약][homepage] 의 1.3.0 버전을 변형하였습니다. +이 행동 강령은 [기여자 규약][homepage] 의 1.3.0 버전을 변형하였습니다. 그 내용은 https://contributor-covenant.org/version/1/3/0/ 에서 확인할 수 있습니다. [homepage]: https://contributor-covenant.org From d720e40d145c6ee181d96575c64d0b6a1c5e26c1 Mon Sep 17 00:00:00 2001 From: Wonjang Son Date: Tue, 5 Oct 2021 14:40:32 +0200 Subject: [PATCH 07/16] Added HOWTO-kr links --- HOWTO-id.md | 14 +++++++------- HOWTO-it.md | 15 +++++++-------- HOWTO-sv.md | 18 +++++++++--------- 3 files changed, 23 insertions(+), 24 deletions(-) diff --git a/HOWTO-id.md b/HOWTO-id.md index 71625aa6095dd..e23cca3f8f6a8 100644 --- a/HOWTO-id.md +++ b/HOWTO-id.md @@ -2,15 +2,15 @@ Baca ini dalam bahasa lain: [Français](HOWTO-fr.md), [Español](HOWTO-es.md), [ Selamat datang di Free-Programming-Books! Kami menyambut kontributor baru; bahkan untuk mereka yang membuat pull request pertama kali di Github. Jika Anda adalah salah satunya, berikut adalah beberapa sumber yang mungkin bisa membantu: -* [Tentang Pull Requests](https://help.github.com/articles/about-pull-requests/) (Dalam Bahasa Inggris) -* [Membuat sebuah pull request](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request) (Dalam Bahasa Inggris) -* [Github Hello World](https://guides.github.com/activities/hello-world/) (Dalam Bahasa Inggris) -* [Youtube - Github Tutorial Untuk Pemula](https://www.youtube.com/watch?v=0fKg7e37bQE) (Dalam Bahasa Inggris) -* [Youtube - Cara Melakukan Fork Pada Github Repositori dan Mengirimkan Sebuah Pull Request](https://www.youtube.com/watch?v=G1I3HF4YWEw) (Dalam Bahasa Inggris) -* [Youtube - Kursus Kilat Markdown](https://www.youtube.com/watch?v=HUBNt18RFbo) (Dalam Bahasa Inggris) +- [Tentang Pull Requests](https://help.github.com/articles/about-pull-requests/) (Dalam Bahasa Inggris) +- [Membuat sebuah pull request](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request) (Dalam Bahasa Inggris) +- [Github Hello World](https://guides.github.com/activities/hello-world/) (Dalam Bahasa Inggris) +- [Youtube - Github Tutorial Untuk Pemula](https://www.youtube.com/watch?v=0fKg7e37bQE) (Dalam Bahasa Inggris) +- [Youtube - Cara Melakukan Fork Pada Github Repositori dan Mengirimkan Sebuah Pull Request](https://www.youtube.com/watch?v=G1I3HF4YWEw) (Dalam Bahasa Inggris) +- [Youtube - Kursus Kilat Markdown](https://www.youtube.com/watch?v=HUBNt18RFbo) (Dalam Bahasa Inggris) Jangan ragu untuk bertanya; setiap kontributor memulainya dengan PR yang pertama. Anda bisa menjadi yang keseribu! Bahkan jika Anda seorang kontributor open source yang berpengalaman, ada hal-hal yang mungkin membuat Anda bingung. Setelah Anda mengirimkan PR Anda, GitHub Actions akan menjalankan linter, dan sering sekali menemukan sedikit masalah dengan spasi atau abjad. Jika Anda mendapatkan tombol hijau, semuanya siap untuk ditinjau, tetapi jika tidak, klik "Detail" di bawah centang yang gagal untuk mengetahui apa yang tidak disukai linter. Perbaiki masalah dan tambahkan commit ke PR Anda. -Terakhir, jika Anda tidak yakin bahwa sumber daya yang ingin Anda tambahkan sesuai untuk Buku Pemrograman Gratis, bacalah panduan di [BERKONTRIBUSI](CONTRIBUTING-id.md). +Terakhir, jika Anda tidak yakin bahwa sumber daya yang ingin Anda tambahkan sesuai untuk Buku Pemrograman Gratis, bacalah panduan di [BERKONTRIBUSI](CONTRIBUTING-id.md). diff --git a/HOWTO-it.md b/HOWTO-it.md index a7f91bf319483..88952bcbac152 100644 --- a/HOWTO-it.md +++ b/HOWTO-it.md @@ -2,16 +2,15 @@ Leggilo in altre lingue: [Deutsch](HOWTO-de.md), [English](HOWTO.md), [Español] Benvenuto su Free-Programming-Books! Diamo il benvenuto ai nuovi collaboratori; anche a quelli che fanno la loro prima pull request su Github. Se sei uno di quelli, ecco qualche risorsa che potrebbe aiutarti: -* [Riguardante le Pull Requests](https://help.github.com/articles/about-pull-requests/) *(in inglese)* -* [Creare una pull request](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request) *(in inglese)* -* [Github Hello World](https://guides.github.com/activities/hello-world/) *(in inglese)* -* [Youtube - Github Tutorial per Principianti](https://www.youtube.com/watch?v=0fKg7e37bQE) *(in inglese)* -* [Youtube - Come forkare una Repository Github e Inviare una Pull Request](https://www.youtube.com/watch?v=G1I3HF4YWEw) *(in inglese)* -* [Youtube - Corso accelerato di Markdown](https://www.youtube.com/watch?v=HUBNt18RFbo) *(in inglese)* - +- [Riguardante le Pull Requests](https://help.github.com/articles/about-pull-requests/) _(in inglese)_ +- [Creare una pull request](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request) _(in inglese)_ +- [Github Hello World](https://guides.github.com/activities/hello-world/) _(in inglese)_ +- [Youtube - Github Tutorial per Principianti](https://www.youtube.com/watch?v=0fKg7e37bQE) _(in inglese)_ +- [Youtube - Come forkare una Repository Github e Inviare una Pull Request](https://www.youtube.com/watch?v=G1I3HF4YWEw) _(in inglese)_ +- [Youtube - Corso accelerato di Markdown](https://www.youtube.com/watch?v=HUBNt18RFbo) _(in inglese)_ Non esitare a fare domande; ogni collaboratore iniziato con una prima pull request (PR). Potresti essere il nostro millesimo collaboratore. -Anche se sei un collaboratore esperto in ambito open source, queste sono cose che potrebbero crearti dei problemi. Una volta che hai inviato la tua PR, Github Actions avvierà un linter, spesso trovando piccoli problemi di spaziatura o di ordinamento alfabetico. Se ottieni una spunta verde, tutto è pronto per una revisione, ma se non è così clicca su "Details" sotto il check che è stato fallito, analizza l'errore, risolvilo e aggiungi un commit alla PR. +Anche se sei un collaboratore esperto in ambito open source, queste sono cose che potrebbero crearti dei problemi. Una volta che hai inviato la tua PR, Github Actions avvierà un linter, spesso trovando piccoli problemi di spaziatura o di ordinamento alfabetico. Se ottieni una spunta verde, tutto è pronto per una revisione, ma se non è così clicca su "Details" sotto il check che è stato fallito, analizza l'errore, risolvilo e aggiungi un commit alla PR. In fine, se non sei sicuro che la risorsa che vuoi aggiungere è appropiata a Free-Programming-Books, leggi le linee guida su [CONTRIBUTING](CONTRIBUTING-it.md). diff --git a/HOWTO-sv.md b/HOWTO-sv.md index 09734930518bf..ef84adc045927 100644 --- a/HOWTO-sv.md +++ b/HOWTO-sv.md @@ -1,16 +1,16 @@ Läs detta på andra språk: [English](HOWTO.md), [Français](HOWTO-fr.md), [简体中文](HOWTO-zh.md), [हिन्दी](HOWTO-hi.md), [繁體中文](HOWTO-zh_TW.md), [Português (BR)](HOWTO-pt_BR.md), [فارسی](HOWTO-fa_IR.md), [Русский](HOWTO-ru.md), [Deutsch](HOWTO-de.md), [Svenska](HOWTO-se.md), [Tiếng Việt](HOWTO-vi.md), [عربي](HOWTO-ar.md), [Українська](HOWTO-uk.md). -Välkommen till *Free-Programming-Books*! Vi välkomnar varmt nya medarbetare, även de som gör sin första Pull Request (PR) på GitHub. Om du är en av dem finns här några resurser som kan hjälpa dig: +Välkommen till _Free-Programming-Books_! Vi välkomnar varmt nya medarbetare, även de som gör sin första Pull Request (PR) på GitHub. Om du är en av dem finns här några resurser som kan hjälpa dig: -* [Om Pull begäran](https://help.github.com/articles/about-pull-requests/) *(på engelska)* -* [Skama en Pull begäran](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request) *(på engelska)* -* [GitHub Hej världen](https://guides.github.com/activities/hello-world/) *(på engelska)* -* [Youtube - GitHub -handledning för nybörjare](https://www.youtube.com/watch?v=0fKg7e37bQE) *(på engelska)* -* [Youtube - Hur man gafflar ett GitHub -arkiv och skickar en pull -begäran](https://www.youtube.com/watch?v=G1I3HF4YWEw) *(på engelska)* -* [Youtube - Curso intensivo de Markdown](https://www.youtube.com/watch?v=HUBNt18RFbo) *(på engelska)* +- [Om Pull begäran](https://help.github.com/articles/about-pull-requests/) _(på engelska)_ +- [Skama en Pull begäran](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request) _(på engelska)_ +- [GitHub Hej världen](https://guides.github.com/activities/hello-world/) _(på engelska)_ +- [Youtube - GitHub -handledning för nybörjare](https://www.youtube.com/watch?v=0fKg7e37bQE) _(på engelska)_ +- [Youtube - Hur man gafflar ett GitHub -arkiv och skickar en pull -begäran](https://www.youtube.com/watch?v=G1I3HF4YWEw) _(på engelska)_ +- [Youtube - Curso intensivo de Markdown](https://www.youtube.com/watch?v=HUBNt18RFbo) _(på engelska)_ Var aldrig i tvivel, eller var rädd för att ställa frågor; varje bidragsgivare som du ser i förvaret började på sin tid med en första PR. Tänk om det är vår tusen-tusendel! -Om du har erfarenhet som bidragsgivare på andra projekt med öppen källkod finns det några saker du kan göra för att få det att fungera. När den skickats till PR, utför *GitHub Actions* en *linter*; som hittar en meny för att hitta små problem med utrymme, utrymme, syntax eller läskunnighet. Om denna slutliga integrationsprocess ska slutföras kommer ljuset och allt är klart för din granskning; men om inte, klicka på "Detaljer för detaljer" som ger det exakta genomsnittet av det du tappade. Lösningen på detta problem och summan av förändringarna i din PR innebär ett nytt engagemang. +Om du har erfarenhet som bidragsgivare på andra projekt med öppen källkod finns det några saker du kan göra för att få det att fungera. När den skickats till PR, utför _GitHub Actions_ en _linter_; som hittar en meny för att hitta små problem med utrymme, utrymme, syntax eller läskunnighet. Om denna slutliga integrationsprocess ska slutföras kommer ljuset och allt är klart för din granskning; men om inte, klicka på "Detaljer för detaljer" som ger det exakta genomsnittet av det du tappade. Lösningen på detta problem och summan av förändringarna i din PR innebär ett nytt engagemang. -I slutändan, om det inte finns någon garanti för att resursen för vilket aggregatet används för *Gratisprogrammeringsböcker*, kan det definitivt hittas i [CONTRIBUTING](CONTRIBUTING.md). +I slutändan, om det inte finns någon garanti för att resursen för vilket aggregatet används för _Gratisprogrammeringsböcker_, kan det definitivt hittas i [CONTRIBUTING](CONTRIBUTING.md). From 67debb175d2cfa4a0d671407a9a463f657dde28b Mon Sep 17 00:00:00 2001 From: Wonjang Son Date: Fri, 8 Oct 2021 16:47:17 +0200 Subject: [PATCH 08/16] Fixed new line & anchors --- CONTRIBUTING-kr.md | 27 ++++++++++++++------------- 1 file changed, 14 insertions(+), 13 deletions(-) diff --git a/CONTRIBUTING-kr.md b/CONTRIBUTING-kr.md index 4b16d9a1b9427..fe3f78f8bd680 100644 --- a/CONTRIBUTING-kr.md +++ b/CONTRIBUTING-kr.md @@ -1,4 +1,4 @@ -*다른 언어로 보기: [Français](CONTRIBUTING-fr.md), [English](CONTRIBUTING.md), [Español](CONTRIBUTING-es.md), [简体中文](CONTRIBUTING-zh.md), [繁體中文](CONTRIBUTING-zh_TW.md), [فارسی](CONTRIBUTING-fa_IR.md), [Tiếng Việt](CONTRIBUTING-vn.md), [Русский](CONTRIBUTING-ru.md), [한국어](CONTRIBUTING-kr.md).* +_다른 언어로 보기: [Français](CONTRIBUTING-fr.md), [English](CONTRIBUTING.md), [Español](CONTRIBUTING-es.md), [简体中文](CONTRIBUTING-zh.md), [繁體中文](CONTRIBUTING-zh_TW.md), [فارسی](CONTRIBUTING-fa_IR.md), [Tiếng Việt](CONTRIBUTING-vn.md), [Русский](CONTRIBUTING-ru.md), [한국어](CONTRIBUTING-kr.md)._ ## 기여자 라이선스 합의 @@ -10,22 +10,23 @@ ## 요약 -1. "책을 쉽게 다운로드할 수 있는 링크"는 늘 *무료* 책에 대한 링크는 아닙니다. 무료 콘텐츠만 제공해주세요. 무료인지 확인하세요. 우리는 책을 얻기 위해 유효한 이메일 주소를 *요구*하는 페이지에 대한 링크를 허용하지 않지만, 책을 요청하는 목록에는 환영합니다. - 2.Git을 알 필요는 없습니다. *이 리포지토리에 아직 없는* 흥미로운 것을 발견했다면 제안하시는 링크를 포함한 [이슈](https://github.com/EbookFoundation/free-programming-books/issues) 여십시오. +1. "책을 쉽게 다운로드할 수 있는 링크"는 늘 _무료_ 책에 대한 링크는 아닙니다. 무료 콘텐츠만 제공해주세요. 무료인지 확인하세요. 우리는 책을 얻기 위해 유효한 이메일 주소를 *요구*하는 페이지에 대한 링크를 허용하지 않지만, 책을 요청하는 목록에는 환영합니다. + 2.Git을 알 필요는 없습니다. _이 리포지토리에 아직 없는_ 흥미로운 것을 발견했다면 제안하시는 링크를 포함한 [이슈](https://github.com/EbookFoundation/free-programming-books/issues) 여십시오. - Git 사용이 가능하시다면 저장소를 포크하고 풀 리퀘스트를 보내주세요. 2. 5가지 종류의 목록이 있습니다. 올바른 것을 선택하십시오.: - - *책* : PDF, HTML, ePub, gitbook.io 사이트, Git 레포지토리, 등. - - *강의* : 코스는 책이 아닌 학습 자료입니다. [이런게 강의입니다](http://rogerdudler.github.io/git-guide/index.ko.html). - - *상호적인 튜터리얼* : 사용자가 코드나 명령을 입력하고 결과를 평가할 수 있는 대화형 웹사이트 ("평가"는 "등급"을 의미하지 않습니다.). 예: [Try Haskell](http://tryhaskell.org), [Try Github](http://try.github.io). - - *팟캐스트와 스크린캐스트* : 팟캐스트와 스크린캐스트. - - *문제 세트 및 경쟁 프로그래밍* : + - _책_ : PDF, HTML, ePub, gitbook.io 사이트, Git 레포지토리, 등. + - _강의_ : 코스는 책이 아닌 학습 자료입니다. [이런게 강의입니다](http://rogerdudler.github.io/git-guide/index.ko.html). + - _상호적인 튜터리얼_ : 사용자가 코드나 명령을 입력하고 결과를 평가할 수 있는 대화형 웹사이트 ("평가"는 "등급"을 의미하지 않습니다.). 예: [Try Haskell](http://tryhaskell.org), [Try Github](http://try.github.io). + - _팟캐스트와 스크린캐스트_ : 팟캐스트와 스크린캐스트. + - _문제 세트 및 경쟁 프로그래밍_ : 다른 사용자와 결과를 비교하거나 코드 검토를 포함하거나 단순 또는 복잡한 문제를 해결하여 프로그래밍 기술을 평가할 수 있는 웹 사이트 또는 소프트웨어입니다. 3. 아래 [가이드 지침](#guidelines)을 따르고 파일의 [마크다운 형식](#formatting)을 준수해야 합니다. 4. GitHub Actions는 목록이 알파벳순으로 정렬되어 있고 형식 지정 규칙을 준수하는지 확인하기 위해 테스트를 실행합니다. 변경 사항이 테스트를 통과했는지 확인하십시오. + ### 가이드 지침 - 책이 무료인지 확인하십시오. 필요한 경우 다시 확인하십시오. 당신의 책이 무료라고 생각하는 이유에 대해 PR에 댓글을 달면 관리자에게 도움이 됩니다. @@ -39,9 +40,9 @@ - URL 단축 링크 불가. - 일반적으로 "버전" 링크보다 "현재" 링크를 선호합니다: `http://example.com/dir/book/current/`가 `http://example.com/dir/book/v1.0.0/index.html` 보다 좋습니다. - 링크에 만료된 인증서/자체 서명된 인증서/다른 종류의 SSL 문제가 있는 경우: - 1. *교체 하십시오*: 가능하면 `http`로 대체합니다(모바일 장치에서는 예외를 수락하는 것이 복잡할 수 있기 때문에). - 2. *그대로 두십시오*: 사용 가능한 `http` 버전이 없다면 브라우저에 예외를 추가하거나 경고를 무시하여 `https`를 통해 링크에 계속 액세스할 수 있는 경우 그대로 두십시오. - 3. 아니라면 *제거하십시오*. + 1. _교체 하십시오_: 가능하면 `http`로 대체합니다(모바일 장치에서는 예외를 수락하는 것이 복잡할 수 있기 때문에). + 2. _그대로 두십시오_: 사용 가능한 `http` 버전이 없다면 브라우저에 예외를 추가하거나 경고를 무시하여 `https`를 통해 링크에 계속 액세스할 수 있는 경우 그대로 두십시오. + 3. 아니라면 _제거하십시오_. - 링크가 여러 형식으로 존재하는 경우 각 형식에 대한 메모와 함께 별도의 링크를 추가하십시오. - 리소스가 인터넷의 다른 위치에 있는 경우: - 가장 권위 있는 출처의 링크를 사용하십시오(작가의 웹사이트가 편집자의 웹사이트보다 낫다는 의미) @@ -49,9 +50,10 @@ - 더 큰 커밋보다 원자적 커밋(추가/삭제/수정에 의한 하나의 커밋)을 선호합니다. PR을 제출하기 전에 커밋을 스쿼시할 필요가 없습니다. (이 규칙은 관리자의 편의를 위한 것이기에 절대로 필수적이지는 않습니다.) - 오래된 책일 경우 제목과 함께 발행일을 포함합니다. - 적절한 경우 저자 이름을 포함합니다. "et al."을 사용하여 저자 목록을 줄일 수 있습니다. -- 책이 완성되지 않았고 아직 작업 중인 경우 [아래 설명(#in_process)]된 대로 "진행 중" 표기법을 추가하십시오. +- 책이 완성되지 않았고 아직 작업 중인 경우 [아래 설명](#in_process)된 대로 "진행 중" 표기법을 추가하십시오. - 다운로드가 활성화되기 전에 이메일 주소 또는 계정 설정이 요청된다면 괄호 안에 언어에 맞는 메모를 추가하십시오., 예: `(이메일 주소 *요청됨*, 필요 없음)` + ### 형식 - 모든 목록은 `.md` 파일입니다. [마크다운](https://guides.github.com/features/mastering-markdown/) 문법을 배워보세요. 간단합니다! @@ -120,7 +122,6 @@ GOOD: * [너무 재밌는 책 (1970)](https://example.org/book.html) - 홍진성 ``` - - 진행 중인 책: ``` From a9a16f4a717810df0597428643b5d9c38606b7be Mon Sep 17 00:00:00 2001 From: Wonjang Son Date: Fri, 8 Oct 2021 21:09:35 +0200 Subject: [PATCH 09/16] Fixed CoC --- CONTRIBUTING-kr.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/CONTRIBUTING-kr.md b/CONTRIBUTING-kr.md index fe3f78f8bd680..8738bcaa77b28 100644 --- a/CONTRIBUTING-kr.md +++ b/CONTRIBUTING-kr.md @@ -6,7 +6,7 @@ _다른 언어로 보기: [Français](CONTRIBUTING-fr.md), [English](CONTRIBUTIN ## 기여자 행동 강령 -기여함으로써 귀하는 이 리포지토리의 다음 [행동강령](https://github.com/EbookFoundation/free-programming-books/blob/master/CODE_OF_CONDUCT.md) 사항에 동의합니다. +기여함으로써 귀하는 이 리포지토리의 다음 [행동강령](https://github.com/EbookFoundation/free-programming-books/blob/master/CODE_OF_CONDUCT-kr.md) 사항에 동의합니다. ## 요약 @@ -27,6 +27,7 @@ _다른 언어로 보기: [Français](CONTRIBUTING-fr.md), [English](CONTRIBUTIN 4. GitHub Actions는 목록이 알파벳순으로 정렬되어 있고 형식 지정 규칙을 준수하는지 확인하기 위해 테스트를 실행합니다. 변경 사항이 테스트를 통과했는지 확인하십시오. + ### 가이드 지침 - 책이 무료인지 확인하십시오. 필요한 경우 다시 확인하십시오. 당신의 책이 무료라고 생각하는 이유에 대해 PR에 댓글을 달면 관리자에게 도움이 됩니다. @@ -54,6 +55,7 @@ _다른 언어로 보기: [Français](CONTRIBUTING-fr.md), [English](CONTRIBUTIN - 다운로드가 활성화되기 전에 이메일 주소 또는 계정 설정이 요청된다면 괄호 안에 언어에 맞는 메모를 추가하십시오., 예: `(이메일 주소 *요청됨*, 필요 없음)` + ### 형식 - 모든 목록은 `.md` 파일입니다. [마크다운](https://guides.github.com/features/mastering-markdown/) 문법을 배워보세요. 간단합니다! @@ -122,6 +124,7 @@ GOOD: * [너무 재밌는 책 (1970)](https://example.org/book.html) - 홍진성 ``` + - 진행 중인 책: ``` From 471df2afef9bc3f3f26ecb6fe35e30f830f8e8bd Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?David=20Ord=C3=A1s?= <3125580+davorpa@users.noreply.github.com> Date: Sat, 9 Oct 2021 00:54:45 +0200 Subject: [PATCH 10/16] chore(docs): fix all annoying markdown problems Finish review EbookFoundation/free-programming-books#5837 --- CONTRIBUTING-kr.md | 92 ++++++++++++++++++++++++++++++---------------- 1 file changed, 60 insertions(+), 32 deletions(-) diff --git a/CONTRIBUTING-kr.md b/CONTRIBUTING-kr.md index 8738bcaa77b28..b03583dded8be 100644 --- a/CONTRIBUTING-kr.md +++ b/CONTRIBUTING-kr.md @@ -1,61 +1,66 @@ -_다른 언어로 보기: [Français](CONTRIBUTING-fr.md), [English](CONTRIBUTING.md), [Español](CONTRIBUTING-es.md), [简体中文](CONTRIBUTING-zh.md), [繁體中文](CONTRIBUTING-zh_TW.md), [فارسی](CONTRIBUTING-fa_IR.md), [Tiếng Việt](CONTRIBUTING-vn.md), [Русский](CONTRIBUTING-ru.md), [한국어](CONTRIBUTING-kr.md)._ +*다른 언어로 보기: [Deutsch](CONTRIBUTING-de.md), [Français](CONTRIBUTING-fr.md), [English](CONTRIBUTING.md), [Español](CONTRIBUTING-es.md), [Italiano](CONTRIBUTING-it.md), [简体中文](CONTRIBUTING-zh.md), [繁體中文](CONTRIBUTING-zh_TW.md), [Português (BR)](HOWTO-pt_BR.md), [فارسی](CONTRIBUTING-fa_IR.md), [Русский](CONTRIBUTING-ru.md), [Bahasa Indonesia](CONTRIBUTING-id.md), [Tiếng Việt](CONTRIBUTING-vn.md), [한국어](CONTRIBUTING-kr.md).* + + ## 기여자 라이선스 합의 기여함으로써 귀하는 이 리포지토리의 다음 [라이선스](https://github.com/EbookFoundation/free-programming-books/blob/master/LICENSE) 사항에 동의합니다. + + ## 기여자 행동 강령 기여함으로써 귀하는 이 리포지토리의 다음 [행동강령](https://github.com/EbookFoundation/free-programming-books/blob/master/CODE_OF_CONDUCT-kr.md) 사항에 동의합니다. + + ## 요약 -1. "책을 쉽게 다운로드할 수 있는 링크"는 늘 _무료_ 책에 대한 링크는 아닙니다. 무료 콘텐츠만 제공해주세요. 무료인지 확인하세요. 우리는 책을 얻기 위해 유효한 이메일 주소를 *요구*하는 페이지에 대한 링크를 허용하지 않지만, 책을 요청하는 목록에는 환영합니다. - 2.Git을 알 필요는 없습니다. _이 리포지토리에 아직 없는_ 흥미로운 것을 발견했다면 제안하시는 링크를 포함한 [이슈](https://github.com/EbookFoundation/free-programming-books/issues) 여십시오. - - Git 사용이 가능하시다면 저장소를 포크하고 풀 리퀘스트를 보내주세요. -2. 5가지 종류의 목록이 있습니다. 올바른 것을 선택하십시오.: +1. "책을 쉽게 다운로드할 수 있는 링크"는 늘 *무료* 책에 대한 링크는 아닙니다. 무료 콘텐츠만 제공해주세요. 무료인지 확인하세요. 우리는 책을 얻기 위해 유효한 이메일 주소를 *요구*하는 페이지에 대한 링크를 허용하지 않지만, 책을 요청하는 목록에는 환영합니다. +2. Git을 알 필요는 없습니다. *이 리포지토리에 아직 없는* 흥미로운 것을 발견했다면 제안하시는 링크를 포함한 [이슈](https://github.com/EbookFoundation/free-programming-books/issues) 여십시오. + - Git 사용이 가능하시다면 저장소를 포크하고 풀 리퀘스트를 보내주세요. +3. 5가지 종류의 목록이 있습니다. 올바른 것을 선택하십시오.: - - _책_ : PDF, HTML, ePub, gitbook.io 사이트, Git 레포지토리, 등. - - _강의_ : 코스는 책이 아닌 학습 자료입니다. [이런게 강의입니다](http://rogerdudler.github.io/git-guide/index.ko.html). - - _상호적인 튜터리얼_ : 사용자가 코드나 명령을 입력하고 결과를 평가할 수 있는 대화형 웹사이트 ("평가"는 "등급"을 의미하지 않습니다.). 예: [Try Haskell](http://tryhaskell.org), [Try Github](http://try.github.io). - - _팟캐스트와 스크린캐스트_ : 팟캐스트와 스크린캐스트. - - _문제 세트 및 경쟁 프로그래밍_ : - 다른 사용자와 결과를 비교하거나 코드 검토를 포함하거나 단순 또는 복잡한 문제를 해결하여 프로그래밍 기술을 평가할 수 있는 웹 사이트 또는 소프트웨어입니다. + - *책* : PDF, HTML, ePub, gitbook.io 사이트, Git 레포지토리, 등. + - *강의* : 코스는 책이 아닌 학습 자료입니다. [이런게 강의입니다](http://rogerdudler.github.io/git-guide/index.ko.html). + - *상호적인 튜터리얼* : 사용자가 코드나 명령을 입력하고 결과를 평가할 수 있는 대화형 웹사이트 ("평가"는 "등급"을 의미하지 않습니다.). 예: [Try Haskell](http://tryhaskell.org), [Try Github](http://try.github.io). + - *팟캐스트와 스크린캐스트* : 팟캐스트와 스크린캐스트. + - *문제 세트 및 경쟁 프로그래밍* : 다른 사용자와 결과를 비교하거나 코드 검토를 포함하거나 단순 또는 복잡한 문제를 해결하여 프로그래밍 기술을 평가할 수 있는 웹 사이트 또는 소프트웨어입니다. -3. 아래 [가이드 지침](#guidelines)을 따르고 파일의 [마크다운 형식](#formatting)을 준수해야 합니다. +4. 아래 [가이드 지침](#guidelines)을 따르고 파일의 [마크다운 형식](#formatting)을 준수해야 합니다. -4. GitHub Actions는 목록이 알파벳순으로 정렬되어 있고 형식 지정 규칙을 준수하는지 확인하기 위해 테스트를 실행합니다. 변경 사항이 테스트를 통과했는지 확인하십시오. +5. GitHub Actions는 목록이 알파벳순으로 정렬되어 있고 형식 지정 규칙을 준수하는지 확인하기 위해 테스트를 실행합니다. 변경 사항이 테스트를 통과했는지 확인하십시오. - + ### 가이드 지침 - 책이 무료인지 확인하십시오. 필요한 경우 다시 확인하십시오. 당신의 책이 무료라고 생각하는 이유에 대해 PR에 댓글을 달면 관리자에게 도움이 됩니다. -- google drive, dropbox, mega, scribd, issuu 또는 유사한 파일 업로드 플랫폼에서 호스팅되는 파일은 허용하지 않습니다. +- Google Drive, Dropbox, Mega, Scribd, Issuu 또는 유사한 파일 업로드 플랫폼에서 호스팅되는 파일은 허용하지 않습니다. - 알파벳 순서로 링크를 삽입하십시오. 잘못된 링크가 있는 경우 다시 수정하여 PR을 제출하세요. - 가장 권위 있는 출처의 링크를 사용하십시오(작가의 웹사이트가 편집자의 웹사이트보다 우수하고 타사 웹사이트보다 우수함을 의미) -- 파일 호스팅 서비스 불가 (여기에는 Dropbox 및 Google Drive 링크가 포함되지만 이에 국한되지 않음) + + 파일 호스팅 서비스 불가 (여기에는 Dropbox 및 Google Drive 링크가 포함되지만 이에 국한되지 않음) - 동일한 도메인에 있고 동일한 콘텐츠를 제공하는 한 항상 `http` 링크보다 `https` 링크를 선호합니다. - 루트 도메인에서 후행 슬래시를 제거합니다: `http://example.com/` 대신 `http://example.com` - 항상 가장 짧은 링크를 선호: `http://example.com/dir/`가 `http://example.com/dir/index.html` 보다 좋습니다. -- URL 단축 링크 불가. + + URL 단축 링크 불가. - 일반적으로 "버전" 링크보다 "현재" 링크를 선호합니다: `http://example.com/dir/book/current/`가 `http://example.com/dir/book/v1.0.0/index.html` 보다 좋습니다. - 링크에 만료된 인증서/자체 서명된 인증서/다른 종류의 SSL 문제가 있는 경우: - 1. _교체 하십시오_: 가능하면 `http`로 대체합니다(모바일 장치에서는 예외를 수락하는 것이 복잡할 수 있기 때문에). - 2. _그대로 두십시오_: 사용 가능한 `http` 버전이 없다면 브라우저에 예외를 추가하거나 경고를 무시하여 `https`를 통해 링크에 계속 액세스할 수 있는 경우 그대로 두십시오. - 3. 아니라면 _제거하십시오_. + 1. *교체 하십시오*: 가능하면 `http`로 대체합니다(모바일 장치에서는 예외를 수락하는 것이 복잡할 수 있기 때문에). + 2. *그대로 두십시오*: 사용 가능한 `http` 버전이 없다면 브라우저에 예외를 추가하거나 경고를 무시하여 `https`를 통해 링크에 계속 액세스할 수 있는 경우 그대로 두십시오. + 3. 아니라면 *제거하십시오*. - 링크가 여러 형식으로 존재하는 경우 각 형식에 대한 메모와 함께 별도의 링크를 추가하십시오. - 리소스가 인터넷의 다른 위치에 있는 경우: - - 가장 권위 있는 출처의 링크를 사용하십시오(작가의 웹사이트가 편집자의 웹사이트보다 낫다는 의미) - - 다른 에디션으로 연결되어 있고 이 에디션이 소장 가치가 있을 만큼 충분히 다르다고 판단되면 각 에디션에 대한 메모가 포함된 별도의 링크를 추가하십시오. ([Issue #2353](https://github.com/EbookFoundation/free-programming-books/issues/2353)를 확인하여 형식 관련 논의에 기여하십시오.) + + 가장 권위 있는 출처의 링크를 사용하십시오(작가의 웹사이트가 편집자의 웹사이트보다 낫다는 의미) + + 다른 에디션으로 연결되어 있고 이 에디션이 소장 가치가 있을 만큼 충분히 다르다고 판단되면 각 에디션에 대한 메모가 포함된 별도의 링크를 추가하십시오. ([Issue #2353](https://github.com/EbookFoundation/free-programming-books/issues/2353)를 확인하여 형식 관련 논의에 기여하십시오.) - 더 큰 커밋보다 원자적 커밋(추가/삭제/수정에 의한 하나의 커밋)을 선호합니다. PR을 제출하기 전에 커밋을 스쿼시할 필요가 없습니다. (이 규칙은 관리자의 편의를 위한 것이기에 절대로 필수적이지는 않습니다.) - 오래된 책일 경우 제목과 함께 발행일을 포함합니다. - 적절한 경우 저자 이름을 포함합니다. "et al."을 사용하여 저자 목록을 줄일 수 있습니다. - 책이 완성되지 않았고 아직 작업 중인 경우 [아래 설명](#in_process)된 대로 "진행 중" 표기법을 추가하십시오. - 다운로드가 활성화되기 전에 이메일 주소 또는 계정 설정이 요청된다면 괄호 안에 언어에 맞는 메모를 추가하십시오., 예: `(이메일 주소 *요청됨*, 필요 없음)` - + ### 형식 - 모든 목록은 `.md` 파일입니다. [마크다운](https://guides.github.com/features/mastering-markdown/) 문법을 배워보세요. 간단합니다! @@ -87,7 +92,7 @@ BAD : * [다른 재밌는 책] (http://example.com/book.html) GOOD: * [다른 재밌는 책](http://example.com/book.html) ``` -- 저자를 포함한다면 `-` 를 사용하십시오 (단일 공백으로 둘러싸인 대시): +- 저자를 포함한다면 ` - ` 를 사용하십시오 (단일 공백으로 둘러싸인 대시): ``` BAD : * [다른 재밌는 책](http://example.com/book.html)- 홍길동 @@ -124,27 +129,34 @@ GOOD: * [너무 재밌는 책 (1970)](https://example.org/book.html) - 홍진성 ``` - - 진행 중인 책: ``` GOOD: * [곧 아주 재밌을 책](http://example.com/book2.html) - 홍길동 (HTML) (:construction: *진행중*) ``` + + ### 노트 기본 사항은 비교적 간단하지만 나열한 리소스에는 매우 다양합니다. 다음은 이러한 다양성을 처리하는 방법에 대한 몇 가지 참고 사항입니다. + + #### 메타데이터 -우리 목록은 제목, URL, 작성자, 플랫폼 및 액세스 정보와 같은 최소한의 메타데이터 집합을 제공합니다. +우리 목록은 제목, URLs, 작성자, 플랫폼 및 액세스 정보와 같은 최소한의 메타데이터 집합을 제공합니다. + + ##### 제목 - 발명된 제목이 없습니다. 리소스 자체에서 제목을 가져오려고 합니다. 기고자는 제목을 만들거나 피할 수 있는 경우 편집용으로 사용하지 말 것을 권고합니다. 오래된 작품은 예외입니다. 주로 역사적 관심이 있는 경우 제목에 괄호 안에 연도를 추가하면 사용자가 관심이 있는지 알 수 있습니다. - ALLCAPS 타이틀이 없습니다. 일반적으로 제목 대소문자가 적절하지만 의심스러운 경우 출처의 대문자를 사용합니다. -##### URL + + +##### URLs - 단축 URL은 허용되지 않습니다. - URL에서 추적 코드를 제거해야 합니다. @@ -152,24 +164,32 @@ GOOD: * [곧 아주 재밌을 책](http://example.com/book2.html) - 홍길동 (H - 보안(https) URL은 https가 구현된 비보안(http) URL보다 항상 선호됩니다. - 우리는 나열된 리소스를 호스팅하지 않고 대신 다른 곳을 가리키는 웹페이지를 가리키는 URL을 좋아하지 않습니다. + + ##### 제작자들 - 번역가를 포함하여 적절한 경우 무료 리소스의 제작자에게 공을 돌리고 싶습니다! - 또는 번역된 작품은 원저자가 표시되어야 합니다. - 크리에이터에 대한 링크는 허용하지 않습니다. -- 편집 또는 리믹스된 작품의 경우 "제작자"에 대한 설명이 필요할 수 있습니다. 예를 들어 "GoalKicker" 책은 "StackOverflow 문서에서 컴파일됨"으로 표시됩니다. +- 편집 또는 리믹스된 작품의 경우 "제작자"에 대한 설명이 필요할 수 있습니다. 예를 들어 "GoalKicker" 책은 "StackOverflow 문서에서 컴파일됨" 으로 표시됩니다. + + ##### 플랫폼 및 액세스 참고 사항 - 강의 또는 코스. 특히 강의 목록의 경우 플랫폼은 리소스 설명의 중요한 부분입니다. 코스 플랫폼마다 어포던스와 액세스 모델이 다르기 때문입니다. 일반적으로 등록이 필요한 책은 나열하지 않지만 많은 코스 플랫폼에는 일종의 계정 없이는 작동하지 않는 어포던스가 있습니다. 코스 플랫폼의 예에는 Coursera, EdX, Udacity 및 Udemy가 있습니다. 과정이 플랫폼에 종속되는 경우 플랫폼 이름은 괄호 안에 나열되어야 합니다. -- 유튜브. YouTube 재생 목록으로 구성된 많은 과정이 있습니다. YouTube를 플랫폼으로 나열하지 않고 종종 하위 플랫폼인 Youtube 제작자를 나열하려고 합니다. +- 유튜브. YouTube 재생 목록으로 구성된 많은 과정이 있습니다. YouTube를 플랫폼으로 나열하지 않고 종종 하위 플랫폼인 YouTube 제작자를 나열하려고 합니다. - 유튜브 동영상. 우리는 일반적으로 1시간 이상 길이가 코스나 튜토리얼처럼 구성되지 않는 한 개별 YouTube 동영상에 링크하지 않습니다. - 린펍. Leanpub은 다양한 액세스 모델로 책을 호스팅합니다. 때로는 등록 없이도 책을 읽을 수 있습니다. 때때로 책은 무료 액세스를 위해 Leanpub 계정이 필요합니다. 책의 품질과 Leanpub 액세스 모델의 혼합 및 유동성을 고려할 때 액세스 메모 *(Leanpub 계정 또는 유효한 이메일 요청)*과 함께 후자의 목록을 허용합니다. + + #### 장르 리소스가 속한 목록을 결정하는 첫 번째 규칙은 리소스가 자체적으로 설명하는 방식을 확인하는 것입니다. 그것이 스스로를 책이라고 부른다면 아마도 그것은 책일 것입니다. + + ##### 포함하지 않은 장르 인터넷은 방대하기 때문에 목록에 포함하지 않습니다: @@ -186,6 +206,8 @@ GOOD: * [곧 아주 재밌을 책](http://example.com/book2.html) - 홍길동 (H 우리의 경쟁 프로그램 목록은 이러한 제외에 대해 엄격하지 않습니다. 리포지토리의 범위는 커뮤니티에서 결정합니다. 범위에 대한 변경이나 추가를 제안하려면 이슈를 사용하여 제안하십시오. + + ##### 책 vs. 기타 리소스 우리는 책에 그렇게 까다롭지 않습니다. 다음은 리소스가 책임을 나타내는 몇 가지 속성입니다: @@ -200,25 +222,31 @@ GOOD: * [곧 아주 재밌을 책](http://example.com/book2.html) - 홍길동 (H 이러한 속성이 없는 많은 책이 나열되어 있습니다. 컨텍스트에 따라 달라질 수 있습니다. + + ##### 책 vs. 강의 때때로 이것들은 구별하기 어려울 수 있습니다! 코스에는 종종 관련 교과서가 있으며, 이는 우리의 도서 목록에 나열됩니다. 코스에는 강의, 연습, 테스트, 메모 또는 기타 교훈적인 보조 자료가 있습니다. 하나의 강의나 비디오 자체는 강의가 아닙니다. 파워포인트는 강의가 아닙니다. + + ##### 상호적인 튜터리얼 vs. 기타 리소스 인쇄하여 본질을 유지할 수 있다면 대화형 자습서가 아닙니다. + + ### 자동화 - 서식 규칙 적용은 [fpb-lint](https://github.com/vhf/free-programming-books-lint)를 사용하여 [GitHub Actions](https://github.com/features/actions)를 통해 자동화됩니다. [.github/workflows/fpb-lint.yml](.github/workflows/fpb-lint.yml) 참조) - URL 유효성 검사는 [awesome_bot](https://github.com/dkhamsing/awesome_bot)을 사용합니다. - URL 유효성 검사를 트리거하려면 `check_urls=file_to_check`가 포함된 커밋 메시지가 포함된 커밋을 푸시합니다.: -``` -check_urls=free-programming-books.md free-programming-books-en.md -``` + ``` + check_urls=free-programming-books.md free-programming-books-en.md + ``` - 각 항목을 구분하는 단일 공백을 사용하여 검사할 파일을 두 개 이상 지정할 수 있습니다. - 파일을 2개 이상 지정할 경우, 마지막으로 확인한 파일의 결과를 기준으로 빌드 결과가 결정됩니다. 이로 인해 녹색 빌드를 통과할 수 있으므로 "모든 검사 표시" -> "세부 정보"를 클릭하여 풀 요청이 끝날 때 빌드 로그를 검사해야 합니다. From 15be9df5e7ec423b570ffb8efcb089031fb055b0 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?David=20Ord=C3=A1s?= <3125580+davorpa@users.noreply.github.com> Date: Sat, 9 Oct 2021 00:55:06 +0200 Subject: [PATCH 11/16] chore(docs): fix all annoying markdown problems Finish review EbookFoundation/free-programming-books#5837 --- CONTRIBUTING.md | 6 +++--- HOWTO-id.md | 2 +- HOWTO-it.md | 2 +- HOWTO-ko.md | 17 ++++++++--------- HOWTO-sv.md | 2 +- 5 files changed, 14 insertions(+), 15 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index db29143e000c5..ebdb5f6bb8ad1 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,4 +1,4 @@ -_Read this in other languages: [Deutsch](CONTRIBUTING-de.md), [Français](CONTRIBUTING-fr.md), [Filipino](CONTRIBUTING-fil.md), [Español](CONTRIBUTING-es.md), [Indonesia](CONTRIBUTING-id.md),[简体中文](CONTRIBUTING-zh.md), [繁體中文](CONTRIBUTING-zh_TW.md), [Português (BR)](CONTRIBUTING-pt_BR.md), [فارسی](CONTRIBUTING-fa_IR.md), [Tiếng Việt](CONTRIBUTING-vn.md), [Русский](CONTRIBUTING-ru.md)._ +_Read this in other languages: [Deutsch](CONTRIBUTING-de.md), [Français](CONTRIBUTING-fr.md), [Español](CONTRIBUTING-es.md), [Indonesia](CONTRIBUTING-id.md), [简体中文](CONTRIBUTING-zh.md), [繁體中文](CONTRIBUTING-zh_TW.md), [فارسی](CONTRIBUTING-fa_IR.md), [Tiếng Việt](CONTRIBUTING-vn.md), [Русский](CONTRIBUTING-ru.md), [한국어](CONTRIBUTING-kr.md)._ ## Contributor License Agreement @@ -19,7 +19,7 @@ By contributing you agree to respect the [Code of Conduct](https://github.com/Eb - _Courses_ : A course is a learning material which is not a book. [This is a course](http://ocw.mit.edu/courses/electrical-engineering-and-computer-science/6-006-introduction-to-algorithms-fall-2011/). - _Interactive Tutorials_ : An interactive website which lets the user type code or commands and evaluates the result (by "evaluate" we don't mean "grade"). e.g.: [Try Haskell](http://tryhaskell.org), [Try Github](http://try.github.io). - _Podcasts and Screencasts_ : Podcasts and screencasts. - - _Problem Sets & Competitive Programming_ : A website or software which lets you assess your programming skills by solving simple or complex problems, with or without code review, with or without comparing the results with other users + - _Problem Sets & Competitive Programming_ : A website or software which lets you assess your programming skills by solving simple or complex problems, with or without code review, with or without comparing the results with other users. 4. Make sure to follow the [guidelines below](#guidelines) and respect the [Markdown formatting](#formatting) of the files. @@ -165,7 +165,7 @@ Our lists provide a minimal set of metadata: titles, URLs, creators, platforms, ##### Platforms and Access Notes -- Courses. Especially for our course lists, the platform is an important part of the resource description. This is because course platforms have different affordances and access models. While we usually won't list a book that requires a registration, many course platforms have affordances that don't work without some sort of account. Example course platforms include Coursera, EdX, Udacity, and Udemy. When a course depends on a platform, the platform name should be listed in parentheses. +- Courses. Especially for our course lists, the platform is an important part of the resource description. This is because course platforms have different affordances and access models. While we usually won't list a book that requires a registration, many course platforms have affordances that don't work without some sort of account. Example course platforms include Coursera, EdX, Udacity and Udemy. When a course depends on a platform, the platform name should be listed in parentheses. - YouTube. We have many courses which consist of YouTube playlists. We do not list Youtube as a platform, we try to list the Youtube creator, which is often a sub-platform. - YouTube videos. We usually don't link to individual YouTube videos unless they are more than an hour long and are structured like a course or a tutorial. - Leanpub. Leanpub hosts books with a variety of access models. Sometimes a book can be read without registration; sometimes a book requires a Leanpub account for free access. Given quality of the books and the mixture and fluidity of Leanpub access models, we permit listing of the latter with the access note _(Leanpub account or valid email requested)_ diff --git a/HOWTO-id.md b/HOWTO-id.md index e23cca3f8f6a8..e5520783ef5c2 100644 --- a/HOWTO-id.md +++ b/HOWTO-id.md @@ -1,4 +1,4 @@ -Baca ini dalam bahasa lain: [Français](HOWTO-fr.md), [Español](HOWTO-es.md), [简体中文](HOWTO-zh.md), [हिन्दी](HOWTO-hi.md), [繁體中文](HOWTO-zh_TW.md), [Português (BR)](HOWTO-pt_BR.md), [فارسی](HOWTO-fa_IR.md), [Русский](HOWTO-ru.md), [Deutsch](HOWTO-de.md), [Bahasa Indonesia](HOWTO-id.md), [Tiếng Việt](HOWTO-vi.md), [عربي](HOWTO-ar.md), [Українська](HOWTO-uk.md). +Baca ini dalam bahasa lain: [Français](HOWTO-fr.md), [Español](HOWTO-es.md), [简体中文](HOWTO-zh.md), [हिन्दी](HOWTO-hi.md), [繁體中文](HOWTO-zh_TW.md), [Português (BR)](HOWTO-pt_BR.md), [فارسی](HOWTO-fa_IR.md), [Русский](HOWTO-ru.md), [Deutsch](HOWTO-de.md), **Bahasa Indonesia**, [Tiếng Việt](HOWTO-vi.md), [عربي](HOWTO-ar.md), [한국어](HOWTO-kr.md). Selamat datang di Free-Programming-Books! Kami menyambut kontributor baru; bahkan untuk mereka yang membuat pull request pertama kali di Github. Jika Anda adalah salah satunya, berikut adalah beberapa sumber yang mungkin bisa membantu: diff --git a/HOWTO-it.md b/HOWTO-it.md index 88952bcbac152..449d042551036 100644 --- a/HOWTO-it.md +++ b/HOWTO-it.md @@ -1,4 +1,4 @@ -Leggilo in altre lingue: [Deutsch](HOWTO-de.md), [English](HOWTO.md), [Español](HOWTO-es.md), [Français](HOWTO-fr.md), **Italiano**, [简体中文](HOWTO-zh.md), [हिन्दी](HOWTO-hi.md), [繁體中文](HOWTO-zh_TW.md), [Português (BR)](HOWTO-pt_BR.md), [فارسی](HOWTO-fa_IR.md), [Русский](HOWTO-ru.md), [Tiếng Việt](HOWTO-vi.md), [عربي](HOWTO-ar.md), [Українська](HOWTO-uk.md). +Leggilo in altre lingue: [Deutsch](HOWTO-de.md), [English](HOWTO.md), [Español](HOWTO-es.md), [Français](HOWTO-fr.md), **Italiano**, [简体中文](HOWTO-zh.md), [हिन्दी](HOWTO-hi.md), [繁體中文](HOWTO-zh_TW.md), [Português (BR)](HOWTO-pt_BR.md), [فارسی](HOWTO-fa_IR.md), [Русский](HOWTO-ru.md), [Tiếng Việt](HOWTO-vi.md), [عربي](HOWTO-ar.md), [한국어](HOWTO-kr.md). Benvenuto su Free-Programming-Books! Diamo il benvenuto ai nuovi collaboratori; anche a quelli che fanno la loro prima pull request su Github. Se sei uno di quelli, ecco qualche risorsa che potrebbe aiutarti: diff --git a/HOWTO-ko.md b/HOWTO-ko.md index f6c52a32eef66..0c9c6f338155e 100644 --- a/HOWTO-ko.md +++ b/HOWTO-ko.md @@ -1,17 +1,16 @@ -다른언어: [English](HOWTO.md), [Français](HOWTO-fr.md), [Español](HOWTO-es.md), [简体中文](HOWTO-zh.md), [हिन्दी](HOWTO-hi.md), [繁體中文](HOWTO-zh_TW.md), [Português (BR)](HOWTO-pt_BR.md), [فارسی](HOWTO-fa_IR.md), [Русский](HOWTO-ru.md), [босански](HOWTO-bs.md), [Deutsch](HOWTO-de.md), [Tiếng Việt](HOWTO-vi.md), [عربي](HOWTO-ar.md), [Українська](HOWTO-uk.md). +다른언어: [English](HOWTO.md), [Français](HOWTO-fr.md), [Español](HOWTO-es.md), [Italiano](HOWTO-it.md), [简体中文](HOWTO-zh.md), [हिन्दी](HOWTO-hi.md), [繁體中文](HOWTO-zh_TW.md), [Português (BR)](HOWTO-pt_BR.md), [فارسی](HOWTO-fa_IR.md), [Русский](HOWTO-ru.md), [Deutsch](HOWTO-de.md), [босански](HOWTO-bs.md), [Bahasa Indonesia](HOWTO-id.md), [Tiếng Việt](HOWTO-vi.md), [عربي](HOWTO-ar.md), **한국어**. Free-Programming-Books 에 오신 것을 환영합니다! 우리는 Github 에 첫 Pull-request 를 분들을 포함한 새로운 기여자들을 환영합니다. 다음 리소스들은 당신에게 도움이 될 수 있습니다: -* [About Pull Requests](https://help.github.com/articles/about-pull-requests/) -* [Creating a pull request](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request) -* [Github Hello World](https://guides.github.com/activities/hello-world/) -* [Youtube - Github Tutorial For Beginners](https://www.youtube.com/watch?v=0fKg7e37bQE) -* [Youtube - How To Fork A GitHub Repo and Submit A Pull Request](https://www.youtube.com/watch?v=G1I3HF4YWEw) -* [Youtube - Markdown Crash Course](https://www.youtube.com/watch?v=HUBNt18RFbo) - +- [About Pull Requests](https://help.github.com/articles/about-pull-requests/) +- [Creating a pull request](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request) +- [Github Hello World](https://guides.github.com/activities/hello-world/) +- [Youtube - Github Tutorial For Beginners](https://www.youtube.com/watch?v=0fKg7e37bQE) +- [Youtube - How To Fork A GitHub Repo and Submit A Pull Request](https://www.youtube.com/watch?v=G1I3HF4YWEw) +- [Youtube - Markdown Crash Course](https://www.youtube.com/watch?v=HUBNt18RFbo) 주저하지 말고 질문하세요. 모든 기여자들 역시 첫 Pull-request 로 시작했습니다. 당신은 우리의 1000번째가 될 수도 있어요! 경험 많은 오픈 소스 기여자라 할지라도, 여러분을 곤란하게 만들 수 있는 것들이 있습니다. 일단 PR을 제출하면 GitHub Actions는 띄어쓰기나 알파벳 순으로 작은 문제를 발견하는 작업을 실행합니다. 녹색 단추가 나타나면 모든 항목을 검토할 준비가 되어 있지만 그렇지 않으면 검사에서 "상세 정보"를 클릭합니다. 문제를 해결하고 PR에 커밋을 추가합니다. -마지막으로 추가하려는 리소스가 Free-Programming-Books에 적합한지 확실하지 않은 경우 [CONTRIBUTING](CONTRIBUTING-ko.md)의 지침을 확인십시오. +마지막으로 추가하려는 리소스가 Free-Programming-Books에 적합한지 확실하지 않은 경우 [CONTRIBUTING](CONTRIBUTING-kr.md)의 지침을 확인십시오. diff --git a/HOWTO-sv.md b/HOWTO-sv.md index ef84adc045927..e23c545c852ea 100644 --- a/HOWTO-sv.md +++ b/HOWTO-sv.md @@ -1,4 +1,4 @@ -Läs detta på andra språk: [English](HOWTO.md), [Français](HOWTO-fr.md), [简体中文](HOWTO-zh.md), [हिन्दी](HOWTO-hi.md), [繁體中文](HOWTO-zh_TW.md), [Português (BR)](HOWTO-pt_BR.md), [فارسی](HOWTO-fa_IR.md), [Русский](HOWTO-ru.md), [Deutsch](HOWTO-de.md), [Svenska](HOWTO-se.md), [Tiếng Việt](HOWTO-vi.md), [عربي](HOWTO-ar.md), [Українська](HOWTO-uk.md). +Läs detta på andra språk: [English](HOWTO.md), [Français](HOWTO-fr.md), [简体中文](HOWTO-zh.md), [हिन्दी](HOWTO-hi.md), [繁體中文](HOWTO-zh_TW.md), [Português (BR)](HOWTO-pt_BR.md), [فارسی](HOWTO-fa_IR.md), [Русский](HOWTO-ru.md), [Deutsch](HOWTO-de.md), [Svenska](HOWTO-se.md), [Tiếng Việt](HOWTO-vi.md), [عربي](HOWTO-ar.md), [한국어](HOWTO-kr.md). Välkommen till _Free-Programming-Books_! Vi välkomnar varmt nya medarbetare, även de som gör sin första Pull Request (PR) på GitHub. Om du är en av dem finns här några resurser som kan hjälpa dig: From 10460793a1d7650917922faaec288e409c1aa504 Mon Sep 17 00:00:00 2001 From: Wonjang Son Date: Wed, 3 Nov 2021 18:30:24 +0900 Subject: [PATCH 12/16] Removed duplicated korean translation --- CONTRIBUTING-kr.md | 252 --------------------------------------------- 1 file changed, 252 deletions(-) delete mode 100644 CONTRIBUTING-kr.md diff --git a/CONTRIBUTING-kr.md b/CONTRIBUTING-kr.md deleted file mode 100644 index b03583dded8be..0000000000000 --- a/CONTRIBUTING-kr.md +++ /dev/null @@ -1,252 +0,0 @@ -*다른 언어로 보기: [Deutsch](CONTRIBUTING-de.md), [Français](CONTRIBUTING-fr.md), [English](CONTRIBUTING.md), [Español](CONTRIBUTING-es.md), [Italiano](CONTRIBUTING-it.md), [简体中文](CONTRIBUTING-zh.md), [繁體中文](CONTRIBUTING-zh_TW.md), [Português (BR)](HOWTO-pt_BR.md), [فارسی](CONTRIBUTING-fa_IR.md), [Русский](CONTRIBUTING-ru.md), [Bahasa Indonesia](CONTRIBUTING-id.md), [Tiếng Việt](CONTRIBUTING-vn.md), [한국어](CONTRIBUTING-kr.md).* - - - -## 기여자 라이선스 합의 - -기여함으로써 귀하는 이 리포지토리의 다음 [라이선스](https://github.com/EbookFoundation/free-programming-books/blob/master/LICENSE) 사항에 동의합니다. - - - -## 기여자 행동 강령 - -기여함으로써 귀하는 이 리포지토리의 다음 [행동강령](https://github.com/EbookFoundation/free-programming-books/blob/master/CODE_OF_CONDUCT-kr.md) 사항에 동의합니다. - - - -## 요약 - -1. "책을 쉽게 다운로드할 수 있는 링크"는 늘 *무료* 책에 대한 링크는 아닙니다. 무료 콘텐츠만 제공해주세요. 무료인지 확인하세요. 우리는 책을 얻기 위해 유효한 이메일 주소를 *요구*하는 페이지에 대한 링크를 허용하지 않지만, 책을 요청하는 목록에는 환영합니다. -2. Git을 알 필요는 없습니다. *이 리포지토리에 아직 없는* 흥미로운 것을 발견했다면 제안하시는 링크를 포함한 [이슈](https://github.com/EbookFoundation/free-programming-books/issues) 여십시오. - - Git 사용이 가능하시다면 저장소를 포크하고 풀 리퀘스트를 보내주세요. -3. 5가지 종류의 목록이 있습니다. 올바른 것을 선택하십시오.: - - - *책* : PDF, HTML, ePub, gitbook.io 사이트, Git 레포지토리, 등. - - *강의* : 코스는 책이 아닌 학습 자료입니다. [이런게 강의입니다](http://rogerdudler.github.io/git-guide/index.ko.html). - - *상호적인 튜터리얼* : 사용자가 코드나 명령을 입력하고 결과를 평가할 수 있는 대화형 웹사이트 ("평가"는 "등급"을 의미하지 않습니다.). 예: [Try Haskell](http://tryhaskell.org), [Try Github](http://try.github.io). - - *팟캐스트와 스크린캐스트* : 팟캐스트와 스크린캐스트. - - *문제 세트 및 경쟁 프로그래밍* : 다른 사용자와 결과를 비교하거나 코드 검토를 포함하거나 단순 또는 복잡한 문제를 해결하여 프로그래밍 기술을 평가할 수 있는 웹 사이트 또는 소프트웨어입니다. - -4. 아래 [가이드 지침](#guidelines)을 따르고 파일의 [마크다운 형식](#formatting)을 준수해야 합니다. - -5. GitHub Actions는 목록이 알파벳순으로 정렬되어 있고 형식 지정 규칙을 준수하는지 확인하기 위해 테스트를 실행합니다. 변경 사항이 테스트를 통과했는지 확인하십시오. - - - -### 가이드 지침 - -- 책이 무료인지 확인하십시오. 필요한 경우 다시 확인하십시오. 당신의 책이 무료라고 생각하는 이유에 대해 PR에 댓글을 달면 관리자에게 도움이 됩니다. -- Google Drive, Dropbox, Mega, Scribd, Issuu 또는 유사한 파일 업로드 플랫폼에서 호스팅되는 파일은 허용하지 않습니다. -- 알파벳 순서로 링크를 삽입하십시오. 잘못된 링크가 있는 경우 다시 수정하여 PR을 제출하세요. -- 가장 권위 있는 출처의 링크를 사용하십시오(작가의 웹사이트가 편집자의 웹사이트보다 우수하고 타사 웹사이트보다 우수함을 의미) - + 파일 호스팅 서비스 불가 (여기에는 Dropbox 및 Google Drive 링크가 포함되지만 이에 국한되지 않음) -- 동일한 도메인에 있고 동일한 콘텐츠를 제공하는 한 항상 `http` 링크보다 `https` 링크를 선호합니다. -- 루트 도메인에서 후행 슬래시를 제거합니다: `http://example.com/` 대신 `http://example.com` -- 항상 가장 짧은 링크를 선호: `http://example.com/dir/`가 `http://example.com/dir/index.html` 보다 좋습니다. - + URL 단축 링크 불가. -- 일반적으로 "버전" 링크보다 "현재" 링크를 선호합니다: `http://example.com/dir/book/current/`가 `http://example.com/dir/book/v1.0.0/index.html` 보다 좋습니다. -- 링크에 만료된 인증서/자체 서명된 인증서/다른 종류의 SSL 문제가 있는 경우: - 1. *교체 하십시오*: 가능하면 `http`로 대체합니다(모바일 장치에서는 예외를 수락하는 것이 복잡할 수 있기 때문에). - 2. *그대로 두십시오*: 사용 가능한 `http` 버전이 없다면 브라우저에 예외를 추가하거나 경고를 무시하여 `https`를 통해 링크에 계속 액세스할 수 있는 경우 그대로 두십시오. - 3. 아니라면 *제거하십시오*. -- 링크가 여러 형식으로 존재하는 경우 각 형식에 대한 메모와 함께 별도의 링크를 추가하십시오. -- 리소스가 인터넷의 다른 위치에 있는 경우: - + 가장 권위 있는 출처의 링크를 사용하십시오(작가의 웹사이트가 편집자의 웹사이트보다 낫다는 의미) - + 다른 에디션으로 연결되어 있고 이 에디션이 소장 가치가 있을 만큼 충분히 다르다고 판단되면 각 에디션에 대한 메모가 포함된 별도의 링크를 추가하십시오. ([Issue #2353](https://github.com/EbookFoundation/free-programming-books/issues/2353)를 확인하여 형식 관련 논의에 기여하십시오.) -- 더 큰 커밋보다 원자적 커밋(추가/삭제/수정에 의한 하나의 커밋)을 선호합니다. PR을 제출하기 전에 커밋을 스쿼시할 필요가 없습니다. (이 규칙은 관리자의 편의를 위한 것이기에 절대로 필수적이지는 않습니다.) -- 오래된 책일 경우 제목과 함께 발행일을 포함합니다. -- 적절한 경우 저자 이름을 포함합니다. "et al."을 사용하여 저자 목록을 줄일 수 있습니다. -- 책이 완성되지 않았고 아직 작업 중인 경우 [아래 설명](#in_process)된 대로 "진행 중" 표기법을 추가하십시오. -- 다운로드가 활성화되기 전에 이메일 주소 또는 계정 설정이 요청된다면 괄호 안에 언어에 맞는 메모를 추가하십시오., 예: `(이메일 주소 *요청됨*, 필요 없음)` - - - -### 형식 - -- 모든 목록은 `.md` 파일입니다. [마크다운](https://guides.github.com/features/mastering-markdown/) 문법을 배워보세요. 간단합니다! -- 모든 목록은 인덱스로 시작합니다. 목록에 있는 모든 섹션과 하위 섹션을 나열하고 연결하는 것입니다. 알파벳 순서로 보관하십시오. -- 섹션에서 레벨 3 헤딩을 사용하고 있습니다. (`###`), 드리고 하위 섹션에서는 레벨 4 헤딩을 사용합니다 (`####`). - -이런 계획입니다: - -- `2`개의 빈 라인은 마지막 링크와 새 섹션 사이. -- `1`개의 빈 라인은 제목과 섹션의 첫 링크 사이. -- `0`개의 빈 라인은 두개의 링크 사이. -- `1`개의 빈 라인은 각 `.md` 파일에 끝에. - -예시: - - [...] - * [재밌는 책](http://example.com/example.html) - (빈 라인) - (빈 라인) - ### 타이틀 예시 - (빈 라인) - * [다른 재밌는 책](http://example.com/book.html) - * [또 다른 책](http://example.com/other.html) - -- `]` 와 `(` 사이에 띄어쓰기를 하지 마십시오: - -``` -BAD : * [다른 재밌는 책] (http://example.com/book.html) -GOOD: * [다른 재밌는 책](http://example.com/book.html) -``` - -- 저자를 포함한다면 ` - ` 를 사용하십시오 (단일 공백으로 둘러싸인 대시): - -``` -BAD : * [다른 재밌는 책](http://example.com/book.html)- 홍길동 -GOOD: * [다른 재밌는 책](http://example.com/book.html) - 홍길동 -``` - -- 링크와 해당 형식 사이에 공백 하나를 넣으십시오: - -``` -BAD : * [너무 재밌는 책](https://example.org/book.pdf)(PDF) -GOOD: * [너무 재밌는 책](https://example.org/book.pdf) (PDF) -``` - -- 저자는 형식보다 이전에 온다: - -``` -BAD : * [너무 재밌는 책](https://example.org/book.pdf)- (PDF) 홍진성 -GOOD: * [너무 재밌는 책](https://example.org/book.pdf) - 홍진성 (PDF) -``` - -- 여러 형식: - -``` -BAD : * [다른 재밌는 책](http://example.com/)- 홍길동 (HTML) -BAD : * [다른 재밌는 책](https://downloads.example.org/book.html)- 홍길동 (download site) -GOOD: * [다른 재밌는 책](http://example.com/) - 홍길동 (HTML) [(PDF, EPUB)](https://downloads.example.org/book.html) -``` - -- 오래된 책의 제목에 발행 연도 포함: - -``` -BAD : * [너무 재밌는 책](https://example.org/book.html) - 홍진성 - 1970 -GOOD: * [너무 재밌는 책 (1970)](https://example.org/book.html) - 홍진성 -``` - - -- 진행 중인 책: - -``` -GOOD: * [곧 아주 재밌을 책](http://example.com/book2.html) - 홍길동 (HTML) (:construction: *진행중*) -``` - - - -### 노트 - -기본 사항은 비교적 간단하지만 나열한 리소스에는 매우 다양합니다. 다음은 이러한 다양성을 처리하는 방법에 대한 몇 가지 참고 사항입니다. - - - -#### 메타데이터 - -우리 목록은 제목, URLs, 작성자, 플랫폼 및 액세스 정보와 같은 최소한의 메타데이터 집합을 제공합니다. - - - -##### 제목 - -- 발명된 제목이 없습니다. 리소스 자체에서 제목을 가져오려고 합니다. 기고자는 제목을 만들거나 피할 수 있는 경우 편집용으로 사용하지 말 것을 권고합니다. 오래된 작품은 예외입니다. 주로 역사적 관심이 있는 경우 제목에 괄호 안에 연도를 추가하면 사용자가 관심이 있는지 알 수 있습니다. -- ALLCAPS 타이틀이 없습니다. 일반적으로 제목 대소문자가 적절하지만 의심스러운 경우 출처의 대문자를 사용합니다. - - - -##### URLs - -- 단축 URL은 허용되지 않습니다. -- URL에서 추적 코드를 제거해야 합니다. -- 국제 URL은 이스케이프 처리해야 합니다. 브라우저 막대는 일반적으로 이를 유니코드로 렌더링하지만 복사하여 붙여넣기를 사용하십시오. -- 보안(https) URL은 https가 구현된 비보안(http) URL보다 항상 선호됩니다. -- 우리는 나열된 리소스를 호스팅하지 않고 대신 다른 곳을 가리키는 웹페이지를 가리키는 URL을 좋아하지 않습니다. - - - -##### 제작자들 - -- 번역가를 포함하여 적절한 경우 무료 리소스의 제작자에게 공을 돌리고 싶습니다! -- 또는 번역된 작품은 원저자가 표시되어야 합니다. -- 크리에이터에 대한 링크는 허용하지 않습니다. -- 편집 또는 리믹스된 작품의 경우 "제작자"에 대한 설명이 필요할 수 있습니다. 예를 들어 "GoalKicker" 책은 "StackOverflow 문서에서 컴파일됨" 으로 표시됩니다. - - - -##### 플랫폼 및 액세스 참고 사항 - -- 강의 또는 코스. 특히 강의 목록의 경우 플랫폼은 리소스 설명의 중요한 부분입니다. 코스 플랫폼마다 어포던스와 액세스 모델이 다르기 때문입니다. 일반적으로 등록이 필요한 책은 나열하지 않지만 많은 코스 플랫폼에는 일종의 계정 없이는 작동하지 않는 어포던스가 있습니다. 코스 플랫폼의 예에는 Coursera, EdX, Udacity 및 Udemy가 있습니다. 과정이 플랫폼에 종속되는 경우 플랫폼 이름은 괄호 안에 나열되어야 합니다. -- 유튜브. YouTube 재생 목록으로 구성된 많은 과정이 있습니다. YouTube를 플랫폼으로 나열하지 않고 종종 하위 플랫폼인 YouTube 제작자를 나열하려고 합니다. -- 유튜브 동영상. 우리는 일반적으로 1시간 이상 길이가 코스나 튜토리얼처럼 구성되지 않는 한 개별 YouTube 동영상에 링크하지 않습니다. -- 린펍. Leanpub은 다양한 액세스 모델로 책을 호스팅합니다. 때로는 등록 없이도 책을 읽을 수 있습니다. 때때로 책은 무료 액세스를 위해 Leanpub 계정이 필요합니다. 책의 품질과 Leanpub 액세스 모델의 혼합 및 유동성을 고려할 때 액세스 메모 *(Leanpub 계정 또는 유효한 이메일 요청)*과 함께 후자의 목록을 허용합니다. - - - -#### 장르 - -리소스가 속한 목록을 결정하는 첫 번째 규칙은 리소스가 자체적으로 설명하는 방식을 확인하는 것입니다. 그것이 스스로를 책이라고 부른다면 아마도 그것은 책일 것입니다. - - - -##### 포함하지 않은 장르 - -인터넷은 방대하기 때문에 목록에 포함하지 않습니다: - -- 블로그 -- 블로그 포스트 -- 아티클 -- 웹사이트 (우리가 나열하는 많은 항목을 호스팅하는 항목을 제외하고.) -- 코스나 스크린캐스트가 아닌 비디오. -- 책의 장 -- 책의 티저 샘플 -- IRC 또는 텔레그램 채널 -- 슬랙스 또는 메일링 리스트 - -우리의 경쟁 프로그램 목록은 이러한 제외에 대해 엄격하지 않습니다. 리포지토리의 범위는 커뮤니티에서 결정합니다. 범위에 대한 변경이나 추가를 제안하려면 이슈를 사용하여 제안하십시오. - - - -##### 책 vs. 기타 리소스 - -우리는 책에 그렇게 까다롭지 않습니다. 다음은 리소스가 책임을 나타내는 몇 가지 속성입니다: - -- ISBN(International Standard Book Number)이 있습니다. -- 목차가 있습니다. -- 다운로드 버전, 특히 ePub 제공 -- 에디션이 있습니다. -- 인터랙티브한 콘텐츠나 동영상에 의존하지 않습니다. -- 주제를 포괄적으로 다루려고 합니다. -- 자체적으로 포함되어 있습니다. - -이러한 속성이 없는 많은 책이 나열되어 있습니다. 컨텍스트에 따라 달라질 수 있습니다. - - - -##### 책 vs. 강의 - -때때로 이것들은 구별하기 어려울 수 있습니다! - -코스에는 종종 관련 교과서가 있으며, 이는 우리의 도서 목록에 나열됩니다. 코스에는 강의, 연습, 테스트, 메모 또는 기타 교훈적인 보조 자료가 있습니다. 하나의 강의나 비디오 자체는 강의가 아닙니다. 파워포인트는 강의가 아닙니다. - - - -##### 상호적인 튜터리얼 vs. 기타 리소스 - -인쇄하여 본질을 유지할 수 있다면 대화형 자습서가 아닙니다. - - - -### 자동화 - -- 서식 규칙 적용은 [fpb-lint](https://github.com/vhf/free-programming-books-lint)를 사용하여 [GitHub Actions](https://github.com/features/actions)를 통해 자동화됩니다. [.github/workflows/fpb-lint.yml](.github/workflows/fpb-lint.yml) 참조) -- URL 유효성 검사는 [awesome_bot](https://github.com/dkhamsing/awesome_bot)을 사용합니다. -- URL 유효성 검사를 트리거하려면 `check_urls=file_to_check`가 포함된 커밋 메시지가 포함된 커밋을 푸시합니다.: - - ``` - check_urls=free-programming-books.md free-programming-books-en.md - ``` - -- 각 항목을 구분하는 단일 공백을 사용하여 검사할 파일을 두 개 이상 지정할 수 있습니다. -- 파일을 2개 이상 지정할 경우, 마지막으로 확인한 파일의 결과를 기준으로 빌드 결과가 결정됩니다. 이로 인해 녹색 빌드를 통과할 수 있으므로 "모든 검사 표시" -> "세부 정보"를 클릭하여 풀 요청이 끝날 때 빌드 로그를 검사해야 합니다. From 6cd01206fb9ef0ad3618b7fd9021433e6d9e7fab Mon Sep 17 00:00:00 2001 From: Wonjang Son Date: Wed, 3 Nov 2021 18:53:17 +0900 Subject: [PATCH 13/16] Revert bad md formatting --- CONTRIBUTING.md | 49 ++++++++++++++++++++++++------------------------- HOWTO-id.md | 16 ++++++++-------- HOWTO-it.md | 17 +++++++++-------- HOWTO-ko.md | 17 +++++++++-------- HOWTO-sv.md | 20 ++++++++++---------- HOWTO.md | 2 +- 6 files changed, 61 insertions(+), 60 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index ebdb5f6bb8ad1..8e3aefda55456 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,4 +1,4 @@ -_Read this in other languages: [Deutsch](CONTRIBUTING-de.md), [Français](CONTRIBUTING-fr.md), [Español](CONTRIBUTING-es.md), [Indonesia](CONTRIBUTING-id.md), [简体中文](CONTRIBUTING-zh.md), [繁體中文](CONTRIBUTING-zh_TW.md), [فارسی](CONTRIBUTING-fa_IR.md), [Tiếng Việt](CONTRIBUTING-vn.md), [Русский](CONTRIBUTING-ru.md), [한국어](CONTRIBUTING-kr.md)._ +*Read this in other languages: [Deutsch](CONTRIBUTING-de.md), [Français](CONTRIBUTING-fr.md), [Filipino](CONTRIBUTING-fil.md), [Español](CONTRIBUTING-es.md), [Indonesia](CONTRIBUTING-id.md),[简体中文](CONTRIBUTING-zh.md), [繁體中文](CONTRIBUTING-zh_TW.md), [Português (BR)](CONTRIBUTING-pt_BR.md), [فارسی](CONTRIBUTING-fa_IR.md), [Tiếng Việt](CONTRIBUTING-vn.md), [Русский](CONTRIBUTING-ru.md), [한국어](CONTRIBUTING-ko.md).* ## Contributor License Agreement @@ -10,41 +10,40 @@ By contributing you agree to respect the [Code of Conduct](https://github.com/Eb ## In a nutshell -1. "A link to easily download a book" is not always a link to a _free_ book. Please only contribute free content. Make sure it's free. We do not accept links to pages that _require_ working email addresses to obtain books, but we welcome listings that request them. -2. You don't have to know Git: if you found something of interest which is _not already in this repo_, please open an [Issue](https://github.com/EbookFoundation/free-programming-books/issues) with your links propositions. - - If you know Git, please Fork the repo and send pull requests. -3. We have 5 kinds of lists. Choose the right one: +- 1. "A link to easily download a book" is not always a link to a *free* book. Please only contribute free content. Make sure it's free. We do not accept links to pages that *require* working email addresses to obtain books, but we welcome listings that request them. +- 2. You don't have to know Git: if you found something of interest which is *not already in this repo*, please open an [Issue](https://github.com/EbookFoundation/free-programming-books/issues) with your links propositions. + - If you know Git, please Fork the repo and send pull requests. +- 3. We have 5 kinds of lists. Choose the right one: - - _Books_ : PDF, HTML, ePub, a gitbook.io based site, a Git repo, etc. - - _Courses_ : A course is a learning material which is not a book. [This is a course](http://ocw.mit.edu/courses/electrical-engineering-and-computer-science/6-006-introduction-to-algorithms-fall-2011/). - - _Interactive Tutorials_ : An interactive website which lets the user type code or commands and evaluates the result (by "evaluate" we don't mean "grade"). e.g.: [Try Haskell](http://tryhaskell.org), [Try Github](http://try.github.io). - - _Podcasts and Screencasts_ : Podcasts and screencasts. - - _Problem Sets & Competitive Programming_ : A website or software which lets you assess your programming skills by solving simple or complex problems, with or without code review, with or without comparing the results with other users. + - *Books* : PDF, HTML, ePub, a gitbook.io based site, a Git repo, etc. + - *Courses* : A course is a learning material which is not a book. [This is a course](http://ocw.mit.edu/courses/electrical-engineering-and-computer-science/6-006-introduction-to-algorithms-fall-2011/). + - *Interactive Tutorials* : An interactive website which lets the user type code or commands and evaluates the result (by "evaluate" we don't mean "grade"). e.g.: [Try Haskell](http://tryhaskell.org), [Try Github](http://try.github.io). + - *Podcasts and Screencasts* : Podcasts and screencasts. + - *Problem Sets & Competitive Programming* : A website or software which lets you assess your programming skills by solving simple or complex problems, with or without code review, with or without comparing the results with other users. 4. Make sure to follow the [guidelines below](#guidelines) and respect the [Markdown formatting](#formatting) of the files. 5. GitHub Actions will run tests to make sure your lists are alphabetized and formatting rules are followed. Be sure to check that your changes pass the tests. ### Guidelines - - make sure a book is free. Double-check if needed. It helps the admins if you comment in the PR as to why you think the book is free. - we don't accept files hosted on Google Drive, Dropbox, Mega, Scribd, Issuu and other similar file upload platforms - insert your links in alphabetical order. If you see a misplaced link, please reorder it and submit a PR - use the link with the most authoritative source (meaning the author's website is better than the editor's website, which is better than a third party website) - - no file hosting services (this includes (but is not limited to) Dropbox and Google Drive links) + + no file hosting services (this includes (but is not limited to) Dropbox and Google Drive links) - always prefer a `https` link over a `http` one -- as long as they are on the same domain and serve the same content - on root domains, strip the trailing slash: `http://example.com` instead of `http://example.com/` - always prefer the shortest link: `http://example.com/dir/` is better than `http://example.com/dir/index.html` - - no URL shortener links + + no URL shortener links - usually prefer the "current" link over the "version" one: `http://example.com/dir/book/current/` is better than `http://example.com/dir/book/v1.0.0/index.html` - if a link has an expired certificate/self-signed certificate/SSL issue of any other kind: - 1. _replace it_ with its `http` counterpart if possible (because accepting exceptions can be complicated on mobile devices). - 2. _leave it_ if no `http` version is available but the link is still accessible through `https` by adding an exception to the browser or ignoring the warning. - 3. _remove it_ otherwise. + 1. *replace it* with its `http` counterpart if possible (because accepting exceptions can be complicated on mobile devices). + 2. *leave it* if no `http` version is available but the link is still accessible through `https` by adding an exception to the browser or ignoring the warning. + 3. *remove it* otherwise. - if a link exists in multiple format, add a separate link with a note about each format - if a resource exists at different places on the Internet - - use the link with the most authoritative source (meaning author's website is better than editor's website is better than third party website) - - if they link to different editions, and you judge these editions are different enough to be worth keeping them, add a separate link with a note about each edition (see [Issue #2353](https://github.com/EbookFoundation/free-programming-books/issues/2353) to contribute to the discussion on formatting.) + + use the link with the most authoritative source (meaning author's website is better than editor's website is better than third party website) + + if they link to different editions and you judge these editions are different enough to be worth keeping them, add a separate link with a note about each edition (see [Issue #2353](https://github.com/EbookFoundation/free-programming-books/issues/2353) to contribute to the discussion on formatting.) - prefer atomic commits (one commit by addition/deletion/modification) over bigger commits. No need to squash your commits before submitting a PR. (We will never enforce this rule as it's just a matter of convenience for the maintainers) - if the book is older, include the publication date with the title. - include the author name or names where appropriate. You can shorten author lists with "et al." @@ -53,13 +52,11 @@ By contributing you agree to respect the [Code of Conduct](https://github.com/Eb - if an email address or account setup is requested before download is enabled, add language-appropriate notes in parentheses, e.g.: `(email address *requested*, not required)` ### Formatting - - All lists are `.md` files. Try to learn [Markdown](https://guides.github.com/features/mastering-markdown/) syntax. It's simple! - All the lists start with an Index. The idea is to list and link all sections and subsections there. Keep it in alphabetical order. - Sections are using level 3 headings (`###`), and subsections are level 4 headings (`####`). The idea is to have: - - `2` empty lines between last link and new section. - `1` empty line between heading & first link of its section. - `0` empty line between two links. @@ -83,7 +80,7 @@ BAD : * [Another Awesome Book] (http://example.com/book.html) GOOD: * [Another Awesome Book](http://example.com/book.html) ``` -- If you include the author, use `-` (a dash surrounded by single spaces): +- If you include the author, use ` - ` (a dash surrounded by single spaces): ``` BAD : * [Another Awesome Book](http://example.com/book.html)- John Doe @@ -120,7 +117,6 @@ GOOD: * [A Very Awesome Book (1970)](https://example.org/book.html) - Jane Roe ``` - - In-process books: ``` @@ -128,7 +124,6 @@ GOOD: * [Will Be An Awesome Book Soon](http://example.com/book2.html) - John Doe ``` - - Archived link: ``` @@ -165,10 +160,10 @@ Our lists provide a minimal set of metadata: titles, URLs, creators, platforms, ##### Platforms and Access Notes -- Courses. Especially for our course lists, the platform is an important part of the resource description. This is because course platforms have different affordances and access models. While we usually won't list a book that requires a registration, many course platforms have affordances that don't work without some sort of account. Example course platforms include Coursera, EdX, Udacity and Udemy. When a course depends on a platform, the platform name should be listed in parentheses. +- Courses. Especially for our course lists, the platform is an important part of the resource description. This is because course platforms have different affordances and access models. While we usually won't list a book that requires a registration, many course platforms have affordances that don't work without some sort of account. Example course platforms include Coursera, EdX, Udacity, and Udemy. When a course depends on a platform, the platform name should be listed in parentheses. - YouTube. We have many courses which consist of YouTube playlists. We do not list Youtube as a platform, we try to list the Youtube creator, which is often a sub-platform. - YouTube videos. We usually don't link to individual YouTube videos unless they are more than an hour long and are structured like a course or a tutorial. -- Leanpub. Leanpub hosts books with a variety of access models. Sometimes a book can be read without registration; sometimes a book requires a Leanpub account for free access. Given quality of the books and the mixture and fluidity of Leanpub access models, we permit listing of the latter with the access note _(Leanpub account or valid email requested)_ +- Leanpub. Leanpub hosts books with a variety of access models. Sometimes a book can be read without registration; sometimes a book requires a Leanpub account for free access. Given quality of the books and the mixture and fluidity of Leanpub access models, we permit listing of the latter with the access note *(Leanpub account or valid email requested)* #### Genres @@ -190,6 +185,7 @@ Because the Internet is vast, we don't include in our lists: Our competitive programming lists are not as strict about these exclusions. The scope of the repo is determined by the community; if you want to suggest a change or addition to the scope, please use an issue to make the suggestion. + ##### Books vs. Other Stuff We're not that fussy about book-ness. Here are some attributes that signify that a resource is a book: @@ -204,16 +200,19 @@ We're not that fussy about book-ness. Here are some attributes that signify that There are lots of books that we list that don't have these attributes; it can depend on context. + ##### Books vs. Courses Sometimes these can be hard to distinguish! Courses often have associated textbooks, which we would list in our books lists. Courses have lectures, exercises, tests, notes or other didactic aids. A single lecture or video by itself is not a course. A powerpoint is not a course. + ##### Interactive Tutorials vs. Other stuff If you can print it out and retain its essence, it's not an Interactive Tutorial. + ### Automation - Formatting rules enforcement is automated via [GitHub Actions](https://github.com/features/actions) using [fpb-lint](https://github.com/vhf/free-programming-books-lint) (see [.github/workflows/fpb-lint.yml](.github/workflows/fpb-lint.yml)) diff --git a/HOWTO-id.md b/HOWTO-id.md index e5520783ef5c2..a4230b2134ab6 100644 --- a/HOWTO-id.md +++ b/HOWTO-id.md @@ -1,16 +1,16 @@ -Baca ini dalam bahasa lain: [Français](HOWTO-fr.md), [Español](HOWTO-es.md), [简体中文](HOWTO-zh.md), [हिन्दी](HOWTO-hi.md), [繁體中文](HOWTO-zh_TW.md), [Português (BR)](HOWTO-pt_BR.md), [فارسی](HOWTO-fa_IR.md), [Русский](HOWTO-ru.md), [Deutsch](HOWTO-de.md), **Bahasa Indonesia**, [Tiếng Việt](HOWTO-vi.md), [عربي](HOWTO-ar.md), [한국어](HOWTO-kr.md). +Baca ini dalam bahasa lain: [Français](HOWTO-fr.md), [Español](HOWTO-es.md), [简体中文](HOWTO-zh.md), [हिन्दी](HOWTO-hi.md), [繁體中文](HOWTO-zh_TW.md), [Português (BR)](HOWTO-pt_BR.md), [فارسی](HOWTO-fa_IR.md), [Русский](HOWTO-ru.md), [Deutsch](HOWTO-de.md), [Bahasa Indonesia](HOWTO-id.md), [Tiếng Việt](HOWTO-vi.md), [عربي](HOWTO-ar.md), [Українська](HOWTO-uk.md), [한국어](HOWTO-ko.md). Selamat datang di Free-Programming-Books! Kami menyambut kontributor baru; bahkan untuk mereka yang membuat pull request pertama kali di Github. Jika Anda adalah salah satunya, berikut adalah beberapa sumber yang mungkin bisa membantu: -- [Tentang Pull Requests](https://help.github.com/articles/about-pull-requests/) (Dalam Bahasa Inggris) -- [Membuat sebuah pull request](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request) (Dalam Bahasa Inggris) -- [Github Hello World](https://guides.github.com/activities/hello-world/) (Dalam Bahasa Inggris) -- [Youtube - Github Tutorial Untuk Pemula](https://www.youtube.com/watch?v=0fKg7e37bQE) (Dalam Bahasa Inggris) -- [Youtube - Cara Melakukan Fork Pada Github Repositori dan Mengirimkan Sebuah Pull Request](https://www.youtube.com/watch?v=G1I3HF4YWEw) (Dalam Bahasa Inggris) -- [Youtube - Kursus Kilat Markdown](https://www.youtube.com/watch?v=HUBNt18RFbo) (Dalam Bahasa Inggris) +* [Tentang Pull Requests](https://help.github.com/articles/about-pull-requests/) (Dalam Bahasa Inggris) +* [Membuat sebuah pull request](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request) (Dalam Bahasa Inggris) +* [Github Hello World](https://guides.github.com/activities/hello-world/) (Dalam Bahasa Inggris) +* [Youtube - Github Tutorial Untuk Pemula](https://www.youtube.com/watch?v=0fKg7e37bQE) (Dalam Bahasa Inggris) +* [Youtube - Cara Melakukan Fork Pada Github Repositori dan Mengirimkan Sebuah Pull Request](https://www.youtube.com/watch?v=G1I3HF4YWEw) (Dalam Bahasa Inggris) +* [Youtube - Kursus Kilat Markdown](https://www.youtube.com/watch?v=HUBNt18RFbo) (Dalam Bahasa Inggris) Jangan ragu untuk bertanya; setiap kontributor memulainya dengan PR yang pertama. Anda bisa menjadi yang keseribu! Bahkan jika Anda seorang kontributor open source yang berpengalaman, ada hal-hal yang mungkin membuat Anda bingung. Setelah Anda mengirimkan PR Anda, GitHub Actions akan menjalankan linter, dan sering sekali menemukan sedikit masalah dengan spasi atau abjad. Jika Anda mendapatkan tombol hijau, semuanya siap untuk ditinjau, tetapi jika tidak, klik "Detail" di bawah centang yang gagal untuk mengetahui apa yang tidak disukai linter. Perbaiki masalah dan tambahkan commit ke PR Anda. -Terakhir, jika Anda tidak yakin bahwa sumber daya yang ingin Anda tambahkan sesuai untuk Buku Pemrograman Gratis, bacalah panduan di [BERKONTRIBUSI](CONTRIBUTING-id.md). +Terakhir, jika Anda tidak yakin bahwa sumber daya yang ingin Anda tambahkan sesuai untuk Buku Pemrograman Gratis, bacalah panduan di [BERKONTRIBUSI](CONTRIBUTING-id.md). diff --git a/HOWTO-it.md b/HOWTO-it.md index 449d042551036..f5aad1ae16cca 100644 --- a/HOWTO-it.md +++ b/HOWTO-it.md @@ -1,16 +1,17 @@ -Leggilo in altre lingue: [Deutsch](HOWTO-de.md), [English](HOWTO.md), [Español](HOWTO-es.md), [Français](HOWTO-fr.md), **Italiano**, [简体中文](HOWTO-zh.md), [हिन्दी](HOWTO-hi.md), [繁體中文](HOWTO-zh_TW.md), [Português (BR)](HOWTO-pt_BR.md), [فارسی](HOWTO-fa_IR.md), [Русский](HOWTO-ru.md), [Tiếng Việt](HOWTO-vi.md), [عربي](HOWTO-ar.md), [한국어](HOWTO-kr.md). +Leggilo in altre lingue: [Deutsch](HOWTO-de.md), [English](HOWTO.md), [Español](HOWTO-es.md), [Français](HOWTO-fr.md), **Italiano**, [简体中文](HOWTO-zh.md), [हिन्दी](HOWTO-hi.md), [繁體中文](HOWTO-zh_TW.md), [Português (BR)](HOWTO-pt_BR.md), [فارسی](HOWTO-fa_IR.md), [Русский](HOWTO-ru.md), [Tiếng Việt](HOWTO-vi.md), [عربي](HOWTO-ar.md), [Українська](HOWTO-uk.md), [한국어](HOWTO-ko.md). Benvenuto su Free-Programming-Books! Diamo il benvenuto ai nuovi collaboratori; anche a quelli che fanno la loro prima pull request su Github. Se sei uno di quelli, ecco qualche risorsa che potrebbe aiutarti: -- [Riguardante le Pull Requests](https://help.github.com/articles/about-pull-requests/) _(in inglese)_ -- [Creare una pull request](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request) _(in inglese)_ -- [Github Hello World](https://guides.github.com/activities/hello-world/) _(in inglese)_ -- [Youtube - Github Tutorial per Principianti](https://www.youtube.com/watch?v=0fKg7e37bQE) _(in inglese)_ -- [Youtube - Come forkare una Repository Github e Inviare una Pull Request](https://www.youtube.com/watch?v=G1I3HF4YWEw) _(in inglese)_ -- [Youtube - Corso accelerato di Markdown](https://www.youtube.com/watch?v=HUBNt18RFbo) _(in inglese)_ +* [Riguardante le Pull Requests](https://help.github.com/articles/about-pull-requests/) *(in inglese)* +* [Creare una pull request](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request) *(in inglese)* +* [Github Hello World](https://guides.github.com/activities/hello-world/) *(in inglese)* +* [Youtube - Github Tutorial per Principianti](https://www.youtube.com/watch?v=0fKg7e37bQE) *(in inglese)* +* [Youtube - Come forkare una Repository Github e Inviare una Pull Request](https://www.youtube.com/watch?v=G1I3HF4YWEw) *(in inglese)* +* [Youtube - Corso accelerato di Markdown](https://www.youtube.com/watch?v=HUBNt18RFbo) *(in inglese)* + Non esitare a fare domande; ogni collaboratore iniziato con una prima pull request (PR). Potresti essere il nostro millesimo collaboratore. -Anche se sei un collaboratore esperto in ambito open source, queste sono cose che potrebbero crearti dei problemi. Una volta che hai inviato la tua PR, Github Actions avvierà un linter, spesso trovando piccoli problemi di spaziatura o di ordinamento alfabetico. Se ottieni una spunta verde, tutto è pronto per una revisione, ma se non è così clicca su "Details" sotto il check che è stato fallito, analizza l'errore, risolvilo e aggiungi un commit alla PR. +Anche se sei un collaboratore esperto in ambito open source, queste sono cose che potrebbero crearti dei problemi. Una volta che hai inviato la tua PR, Github Actions avvierà un linter, spesso trovando piccoli problemi di spaziatura o di ordinamento alfabetico. Se ottieni una spunta verde, tutto è pronto per una revisione, ma se non è così clicca su "Details" sotto il check che è stato fallito, analizza l'errore, risolvilo e aggiungi un commit alla PR. In fine, se non sei sicuro che la risorsa che vuoi aggiungere è appropiata a Free-Programming-Books, leggi le linee guida su [CONTRIBUTING](CONTRIBUTING-it.md). diff --git a/HOWTO-ko.md b/HOWTO-ko.md index 0c9c6f338155e..13f222bf32b94 100644 --- a/HOWTO-ko.md +++ b/HOWTO-ko.md @@ -1,16 +1,17 @@ -다른언어: [English](HOWTO.md), [Français](HOWTO-fr.md), [Español](HOWTO-es.md), [Italiano](HOWTO-it.md), [简体中文](HOWTO-zh.md), [हिन्दी](HOWTO-hi.md), [繁體中文](HOWTO-zh_TW.md), [Português (BR)](HOWTO-pt_BR.md), [فارسی](HOWTO-fa_IR.md), [Русский](HOWTO-ru.md), [Deutsch](HOWTO-de.md), [босански](HOWTO-bs.md), [Bahasa Indonesia](HOWTO-id.md), [Tiếng Việt](HOWTO-vi.md), [عربي](HOWTO-ar.md), **한국어**. +다른언어: [English](HOWTO.md), [Français](HOWTO-fr.md), [Español](HOWTO-es.md), [简体中文](HOWTO-zh.md), [हिन्दी](HOWTO-hi.md), [繁體中文](HOWTO-zh_TW.md), [Português (BR)](HOWTO-pt_BR.md), [فارسی](HOWTO-fa_IR.md), [Русский](HOWTO-ru.md), [босански](HOWTO-bs.md), [Deutsch](HOWTO-de.md), [Tiếng Việt](HOWTO-vi.md), [عربي](HOWTO-ar.md), [Українська](HOWTO-uk.md), [한국어](HOWTO-ko.md). Free-Programming-Books 에 오신 것을 환영합니다! 우리는 Github 에 첫 Pull-request 를 분들을 포함한 새로운 기여자들을 환영합니다. 다음 리소스들은 당신에게 도움이 될 수 있습니다: -- [About Pull Requests](https://help.github.com/articles/about-pull-requests/) -- [Creating a pull request](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request) -- [Github Hello World](https://guides.github.com/activities/hello-world/) -- [Youtube - Github Tutorial For Beginners](https://www.youtube.com/watch?v=0fKg7e37bQE) -- [Youtube - How To Fork A GitHub Repo and Submit A Pull Request](https://www.youtube.com/watch?v=G1I3HF4YWEw) -- [Youtube - Markdown Crash Course](https://www.youtube.com/watch?v=HUBNt18RFbo) +* [About Pull Requests](https://help.github.com/articles/about-pull-requests/) +* [Creating a pull request](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request) +* [Github Hello World](https://guides.github.com/activities/hello-world/) +* [Youtube - Github Tutorial For Beginners](https://www.youtube.com/watch?v=0fKg7e37bQE) +* [Youtube - How To Fork A GitHub Repo and Submit A Pull Request](https://www.youtube.com/watch?v=G1I3HF4YWEw) +* [Youtube - Markdown Crash Course](https://www.youtube.com/watch?v=HUBNt18RFbo) + 주저하지 말고 질문하세요. 모든 기여자들 역시 첫 Pull-request 로 시작했습니다. 당신은 우리의 1000번째가 될 수도 있어요! 경험 많은 오픈 소스 기여자라 할지라도, 여러분을 곤란하게 만들 수 있는 것들이 있습니다. 일단 PR을 제출하면 GitHub Actions는 띄어쓰기나 알파벳 순으로 작은 문제를 발견하는 작업을 실행합니다. 녹색 단추가 나타나면 모든 항목을 검토할 준비가 되어 있지만 그렇지 않으면 검사에서 "상세 정보"를 클릭합니다. 문제를 해결하고 PR에 커밋을 추가합니다. -마지막으로 추가하려는 리소스가 Free-Programming-Books에 적합한지 확실하지 않은 경우 [CONTRIBUTING](CONTRIBUTING-kr.md)의 지침을 확인십시오. +마지막으로 추가하려는 리소스가 Free-Programming-Books에 적합한지 확실하지 않은 경우 [CONTRIBUTING](CONTRIBUTING-ko.md)의 지침을 확인십시오. diff --git a/HOWTO-sv.md b/HOWTO-sv.md index e23c545c852ea..3a547bde5fd15 100644 --- a/HOWTO-sv.md +++ b/HOWTO-sv.md @@ -1,16 +1,16 @@ -Läs detta på andra språk: [English](HOWTO.md), [Français](HOWTO-fr.md), [简体中文](HOWTO-zh.md), [हिन्दी](HOWTO-hi.md), [繁體中文](HOWTO-zh_TW.md), [Português (BR)](HOWTO-pt_BR.md), [فارسی](HOWTO-fa_IR.md), [Русский](HOWTO-ru.md), [Deutsch](HOWTO-de.md), [Svenska](HOWTO-se.md), [Tiếng Việt](HOWTO-vi.md), [عربي](HOWTO-ar.md), [한국어](HOWTO-kr.md). +Läs detta på andra språk: [English](HOWTO.md), [Français](HOWTO-fr.md), [简体中文](HOWTO-zh.md), [हिन्दी](HOWTO-hi.md), [繁體中文](HOWTO-zh_TW.md), [Português (BR)](HOWTO-pt_BR.md), [فارسی](HOWTO-fa_IR.md), [Русский](HOWTO-ru.md), [Deutsch](HOWTO-de.md), [Svenska](HOWTO-se.md), [Tiếng Việt](HOWTO-vi.md), [عربي](HOWTO-ar.md), [Українська](HOWTO-uk.md), [한국어](HOWTO-ko.md). -Välkommen till _Free-Programming-Books_! Vi välkomnar varmt nya medarbetare, även de som gör sin första Pull Request (PR) på GitHub. Om du är en av dem finns här några resurser som kan hjälpa dig: +Välkommen till *Free-Programming-Books*! Vi välkomnar varmt nya medarbetare, även de som gör sin första Pull Request (PR) på GitHub. Om du är en av dem finns här några resurser som kan hjälpa dig: -- [Om Pull begäran](https://help.github.com/articles/about-pull-requests/) _(på engelska)_ -- [Skama en Pull begäran](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request) _(på engelska)_ -- [GitHub Hej världen](https://guides.github.com/activities/hello-world/) _(på engelska)_ -- [Youtube - GitHub -handledning för nybörjare](https://www.youtube.com/watch?v=0fKg7e37bQE) _(på engelska)_ -- [Youtube - Hur man gafflar ett GitHub -arkiv och skickar en pull -begäran](https://www.youtube.com/watch?v=G1I3HF4YWEw) _(på engelska)_ -- [Youtube - Curso intensivo de Markdown](https://www.youtube.com/watch?v=HUBNt18RFbo) _(på engelska)_ +* [Om Pull begäran](https://help.github.com/articles/about-pull-requests/) *(på engelska)* +* [Skama en Pull begäran](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request) *(på engelska)* +* [GitHub Hej världen](https://guides.github.com/activities/hello-world/) *(på engelska)* +* [Youtube - GitHub -handledning för nybörjare](https://www.youtube.com/watch?v=0fKg7e37bQE) *(på engelska)* +* [Youtube - Hur man gafflar ett GitHub -arkiv och skickar en pull -begäran](https://www.youtube.com/watch?v=G1I3HF4YWEw) *(på engelska)* +* [Youtube - Curso intensivo de Markdown](https://www.youtube.com/watch?v=HUBNt18RFbo) *(på engelska)* Var aldrig i tvivel, eller var rädd för att ställa frågor; varje bidragsgivare som du ser i förvaret började på sin tid med en första PR. Tänk om det är vår tusen-tusendel! -Om du har erfarenhet som bidragsgivare på andra projekt med öppen källkod finns det några saker du kan göra för att få det att fungera. När den skickats till PR, utför _GitHub Actions_ en _linter_; som hittar en meny för att hitta små problem med utrymme, utrymme, syntax eller läskunnighet. Om denna slutliga integrationsprocess ska slutföras kommer ljuset och allt är klart för din granskning; men om inte, klicka på "Detaljer för detaljer" som ger det exakta genomsnittet av det du tappade. Lösningen på detta problem och summan av förändringarna i din PR innebär ett nytt engagemang. +Om du har erfarenhet som bidragsgivare på andra projekt med öppen källkod finns det några saker du kan göra för att få det att fungera. När den skickats till PR, utför *GitHub Actions* en *linter*; som hittar en meny för att hitta små problem med utrymme, utrymme, syntax eller läskunnighet. Om denna slutliga integrationsprocess ska slutföras kommer ljuset och allt är klart för din granskning; men om inte, klicka på "Detaljer för detaljer" som ger det exakta genomsnittet av det du tappade. Lösningen på detta problem och summan av förändringarna i din PR innebär ett nytt engagemang. -I slutändan, om det inte finns någon garanti för att resursen för vilket aggregatet används för _Gratisprogrammeringsböcker_, kan det definitivt hittas i [CONTRIBUTING](CONTRIBUTING.md). +I slutändan, om det inte finns någon garanti för att resursen för vilket aggregatet används för *Gratisprogrammeringsböcker*, kan det definitivt hittas i [CONTRIBUTING](CONTRIBUTING.md). diff --git a/HOWTO.md b/HOWTO.md index c1bdd69ced9ac..c339523f6fed3 100644 --- a/HOWTO.md +++ b/HOWTO.md @@ -1,4 +1,4 @@ -Read this in other languages: [Français](HOWTO-fr.md), [Español](HOWTO-es.md), [Filipino](HOWTO-fil.md), [简体中文](HOWTO-zh.md), [हिन्दी](HOWTO-hi.md), [繁體中文](HOWTO-zh_TW.md), [Português (BR)](HOWTO-pt_BR.md), [فارسی](HOWTO-fa_IR.md), [Русский](HOWTO-ru.md), [Deutsch](HOWTO-de.md), [Bahasa Indonesia](HOWTO-id.md), [Tiếng Việt](HOWTO-vi.md), [عربي](HOWTO-ar.md), [Українська](HOWTO-uk.md). +Read this in other languages: [Français](HOWTO-fr.md), [Español](HOWTO-es.md), [Filipino](HOWTO-fil.md), [简体中文](HOWTO-zh.md), [हिन्दी](HOWTO-hi.md), [繁體中文](HOWTO-zh_TW.md), [Português (BR)](HOWTO-pt_BR.md), [فارسی](HOWTO-fa_IR.md), [Русский](HOWTO-ru.md), [Deutsch](HOWTO-de.md), [Bahasa Indonesia](HOWTO-id.md), [Tiếng Việt](HOWTO-vi.md), [عربي](HOWTO-ar.md), [Українська](HOWTO-uk.md), , [한국어](HOWTO-ko.md). Welcome to Free-Programming-Books! We welcome new contributors; even those making their very first pull request on Github. If you're one of those, here are some resources that might help: From d0746b8d7d2c94f7c2c84ed05224031ccbba8706 Mon Sep 17 00:00:00 2001 From: Wonjang Son Date: Wed, 3 Nov 2021 18:57:44 +0900 Subject: [PATCH 14/16] Fixed inconsistencies --- CONTRIBUTING.md | 16 +++++++--------- HOWTO.md | 2 +- 2 files changed, 8 insertions(+), 10 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 8e3aefda55456..39e50c402f1eb 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,19 +1,17 @@ *Read this in other languages: [Deutsch](CONTRIBUTING-de.md), [Français](CONTRIBUTING-fr.md), [Filipino](CONTRIBUTING-fil.md), [Español](CONTRIBUTING-es.md), [Indonesia](CONTRIBUTING-id.md),[简体中文](CONTRIBUTING-zh.md), [繁體中文](CONTRIBUTING-zh_TW.md), [Português (BR)](CONTRIBUTING-pt_BR.md), [فارسی](CONTRIBUTING-fa_IR.md), [Tiếng Việt](CONTRIBUTING-vn.md), [Русский](CONTRIBUTING-ru.md), [한국어](CONTRIBUTING-ko.md).* ## Contributor License Agreement - By contributing you agree to the [LICENSE](https://github.com/EbookFoundation/free-programming-books/blob/master/LICENSE) of this repository. ## Contributor Code of Conduct - By contributing you agree to respect the [Code of Conduct](https://github.com/EbookFoundation/free-programming-books/blob/master/CODE_OF_CONDUCT.md) of this repository. ## In a nutshell -- 1. "A link to easily download a book" is not always a link to a *free* book. Please only contribute free content. Make sure it's free. We do not accept links to pages that *require* working email addresses to obtain books, but we welcome listings that request them. -- 2. You don't have to know Git: if you found something of interest which is *not already in this repo*, please open an [Issue](https://github.com/EbookFoundation/free-programming-books/issues) with your links propositions. +1. "A link to easily download a book" is not always a link to a *free* book. Please only contribute free content. Make sure it's free. We do not accept links to pages that *require* working email addresses to obtain books, but we welcome listings that request them. +2. You don't have to know Git: if you found something of interest which is *not already in this repo*, please open an [Issue](https://github.com/EbookFoundation/free-programming-books/issues) with your links propositions. - If you know Git, please Fork the repo and send pull requests. -- 3. We have 5 kinds of lists. Choose the right one: +3. We have 5 kinds of lists. Choose the right one: - *Books* : PDF, HTML, ePub, a gitbook.io based site, a Git repo, etc. - *Courses* : A course is a learning material which is not a book. [This is a course](http://ocw.mit.edu/courses/electrical-engineering-and-computer-science/6-006-introduction-to-algorithms-fall-2011/). @@ -30,11 +28,11 @@ By contributing you agree to respect the [Code of Conduct](https://github.com/Eb - we don't accept files hosted on Google Drive, Dropbox, Mega, Scribd, Issuu and other similar file upload platforms - insert your links in alphabetical order. If you see a misplaced link, please reorder it and submit a PR - use the link with the most authoritative source (meaning the author's website is better than the editor's website, which is better than a third party website) - + no file hosting services (this includes (but is not limited to) Dropbox and Google Drive links) + + no file hosting services (this includes (but is not limited to) Dropbox and Google Drive links) - always prefer a `https` link over a `http` one -- as long as they are on the same domain and serve the same content - on root domains, strip the trailing slash: `http://example.com` instead of `http://example.com/` - always prefer the shortest link: `http://example.com/dir/` is better than `http://example.com/dir/index.html` - + no URL shortener links + + no URL shortener links - usually prefer the "current" link over the "version" one: `http://example.com/dir/book/current/` is better than `http://example.com/dir/book/v1.0.0/index.html` - if a link has an expired certificate/self-signed certificate/SSL issue of any other kind: 1. *replace it* with its `http` counterpart if possible (because accepting exceptions can be complicated on mobile devices). @@ -42,8 +40,8 @@ By contributing you agree to respect the [Code of Conduct](https://github.com/Eb 3. *remove it* otherwise. - if a link exists in multiple format, add a separate link with a note about each format - if a resource exists at different places on the Internet - + use the link with the most authoritative source (meaning author's website is better than editor's website is better than third party website) - + if they link to different editions and you judge these editions are different enough to be worth keeping them, add a separate link with a note about each edition (see [Issue #2353](https://github.com/EbookFoundation/free-programming-books/issues/2353) to contribute to the discussion on formatting.) + + use the link with the most authoritative source (meaning author's website is better than editor's website is better than third party website) + + if they link to different editions and you judge these editions are different enough to be worth keeping them, add a separate link with a note about each edition (see [Issue #2353](https://github.com/EbookFoundation/free-programming-books/issues/2353) to contribute to the discussion on formatting.) - prefer atomic commits (one commit by addition/deletion/modification) over bigger commits. No need to squash your commits before submitting a PR. (We will never enforce this rule as it's just a matter of convenience for the maintainers) - if the book is older, include the publication date with the title. - include the author name or names where appropriate. You can shorten author lists with "et al." diff --git a/HOWTO.md b/HOWTO.md index c339523f6fed3..1853eb460619e 100644 --- a/HOWTO.md +++ b/HOWTO.md @@ -1,4 +1,4 @@ -Read this in other languages: [Français](HOWTO-fr.md), [Español](HOWTO-es.md), [Filipino](HOWTO-fil.md), [简体中文](HOWTO-zh.md), [हिन्दी](HOWTO-hi.md), [繁體中文](HOWTO-zh_TW.md), [Português (BR)](HOWTO-pt_BR.md), [فارسی](HOWTO-fa_IR.md), [Русский](HOWTO-ru.md), [Deutsch](HOWTO-de.md), [Bahasa Indonesia](HOWTO-id.md), [Tiếng Việt](HOWTO-vi.md), [عربي](HOWTO-ar.md), [Українська](HOWTO-uk.md), , [한국어](HOWTO-ko.md). +Read this in other languages: [Français](HOWTO-fr.md), [Español](HOWTO-es.md), [Filipino](HOWTO-fil.md), [简体中文](HOWTO-zh.md), [हिन्दी](HOWTO-hi.md), [繁體中文](HOWTO-zh_TW.md), [Português (BR)](HOWTO-pt_BR.md), [فارسی](HOWTO-fa_IR.md), [Русский](HOWTO-ru.md), [Deutsch](HOWTO-de.md), [Bahasa Indonesia](HOWTO-id.md), [Tiếng Việt](HOWTO-vi.md), [عربي](HOWTO-ar.md), [Українська](HOWTO-uk.md), [한국어](HOWTO-ko.md). Welcome to Free-Programming-Books! We welcome new contributors; even those making their very first pull request on Github. If you're one of those, here are some resources that might help: From c7759fa1c0f132c89806d4f4809da5be187ae2ba Mon Sep 17 00:00:00 2001 From: Wonjang Son Date: Wed, 3 Nov 2021 19:00:55 +0900 Subject: [PATCH 15/16] Fixed indentation --- CONTRIBUTING.md | 15 +++++++-------- 1 file changed, 7 insertions(+), 8 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 39e50c402f1eb..b23987d593cd8 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -7,17 +7,16 @@ By contributing you agree to the [LICENSE](https://github.com/EbookFoundation/fr By contributing you agree to respect the [Code of Conduct](https://github.com/EbookFoundation/free-programming-books/blob/master/CODE_OF_CONDUCT.md) of this repository. ## In a nutshell - 1. "A link to easily download a book" is not always a link to a *free* book. Please only contribute free content. Make sure it's free. We do not accept links to pages that *require* working email addresses to obtain books, but we welcome listings that request them. 2. You don't have to know Git: if you found something of interest which is *not already in this repo*, please open an [Issue](https://github.com/EbookFoundation/free-programming-books/issues) with your links propositions. - - If you know Git, please Fork the repo and send pull requests. + - If you know Git, please Fork the repo and send pull requests. 3. We have 5 kinds of lists. Choose the right one: - - *Books* : PDF, HTML, ePub, a gitbook.io based site, a Git repo, etc. - - *Courses* : A course is a learning material which is not a book. [This is a course](http://ocw.mit.edu/courses/electrical-engineering-and-computer-science/6-006-introduction-to-algorithms-fall-2011/). - - *Interactive Tutorials* : An interactive website which lets the user type code or commands and evaluates the result (by "evaluate" we don't mean "grade"). e.g.: [Try Haskell](http://tryhaskell.org), [Try Github](http://try.github.io). - - *Podcasts and Screencasts* : Podcasts and screencasts. - - *Problem Sets & Competitive Programming* : A website or software which lets you assess your programming skills by solving simple or complex problems, with or without code review, with or without comparing the results with other users. + - *Books* : PDF, HTML, ePub, a gitbook.io based site, a Git repo, etc. + - *Courses* : A course is a learning material which is not a book. [This is a course](http://ocw.mit.edu/courses/electrical-engineering-and-computer-science/6-006-introduction-to-algorithms-fall-2011/). + - *Interactive Tutorials* : An interactive website which lets the user type code or commands and evaluates the result (by "evaluate" we don't mean "grade"). e.g.: [Try Haskell](http://tryhaskell.org), [Try Github](http://try.github.io). + - *Podcasts and Screencasts* : Podcasts and screencasts. + - *Problem Sets & Competitive Programming* : A website or software which lets you assess your programming skills by solving simple or complex problems, with or without code review, with or without comparing the results with other users. 4. Make sure to follow the [guidelines below](#guidelines) and respect the [Markdown formatting](#formatting) of the files. @@ -41,7 +40,7 @@ By contributing you agree to respect the [Code of Conduct](https://github.com/Eb - if a link exists in multiple format, add a separate link with a note about each format - if a resource exists at different places on the Internet + use the link with the most authoritative source (meaning author's website is better than editor's website is better than third party website) - + if they link to different editions and you judge these editions are different enough to be worth keeping them, add a separate link with a note about each edition (see [Issue #2353](https://github.com/EbookFoundation/free-programming-books/issues/2353) to contribute to the discussion on formatting.) + + if they link to different editions, and you judge these editions are different enough to be worth keeping them, add a separate link with a note about each edition (see [Issue #2353](https://github.com/EbookFoundation/free-programming-books/issues/2353) to contribute to the discussion on formatting.) - prefer atomic commits (one commit by addition/deletion/modification) over bigger commits. No need to squash your commits before submitting a PR. (We will never enforce this rule as it's just a matter of convenience for the maintainers) - if the book is older, include the publication date with the title. - include the author name or names where appropriate. You can shorten author lists with "et al." From a32f99919f432167595fedf0b3142ecd1404ba88 Mon Sep 17 00:00:00 2001 From: Wonjang Son Date: Wed, 3 Nov 2021 19:11:09 +0900 Subject: [PATCH 16/16] Added missing korean links --- CONTRIBUTING-de.md | 2 +- CONTRIBUTING-el.md | 2 +- CONTRIBUTING-es.md | 2 +- CONTRIBUTING-fa_IR.md | 2 +- CONTRIBUTING-fil.md | 2 +- CONTRIBUTING-fr.md | 2 +- CONTRIBUTING-id.md | 2 +- CONTRIBUTING-it.md | 2 +- CONTRIBUTING-pt_BR.md | 2 +- CONTRIBUTING-ru.md | 2 +- CONTRIBUTING-vi.md | 2 +- CONTRIBUTING-zh.md | 2 +- CONTRIBUTING-zh_TW.md | 2 +- HOWTO-ar.md | 2 +- HOWTO-el.md | 2 +- HOWTO-fil.md | 2 +- HOWTO-km.md | 2 +- HOWTO-ko.md | 2 +- HOWTO-pl.md | 2 +- HOWTO-sl.md | 2 +- HOWTO-th.md | 2 +- HOWTO-uk.md | 2 +- HOWTO-vi.md | 2 +- 23 files changed, 23 insertions(+), 23 deletions(-) diff --git a/CONTRIBUTING-de.md b/CONTRIBUTING-de.md index 43ebac7176b56..a0cd4f1e02d08 100644 --- a/CONTRIBUTING-de.md +++ b/CONTRIBUTING-de.md @@ -1,4 +1,4 @@ -*Diese Anleitung in anderen Sprachen: [Français](CONTRIBUTING-fr.md), [Español](CONTRIBUTING-es.md), [简体中文](CONTRIBUTING-zh.md), [繁體中文](CONTRIBUTING-zh_TW.md), [فارسی](CONTRIBUTING-fa_IR.md), [Tiếng Việt](CONTRIBUTING-vn.md), [Русский](CONTRIBUTING-ru.md), [Português Brasileiro](CONTRIBUTING-pt_BR.md).* +*Diese Anleitung in anderen Sprachen: [Français](CONTRIBUTING-fr.md), [Español](CONTRIBUTING-es.md), [简体中文](CONTRIBUTING-zh.md), [繁體中文](CONTRIBUTING-zh_TW.md), [فارسی](CONTRIBUTING-fa_IR.md), [Tiếng Việt](CONTRIBUTING-vn.md), [Русский](CONTRIBUTING-ru.md), [Português Brasileiro](CONTRIBUTING-pt_BR.md), [한국어](CONTRIBUTING-ko.md).* ## Lizenzvereinbarung für Mitwirkende Durch Deine Mitwirkung akzeptierst Du die [Lizenz](https://github.com/EbookFoundation/free-programming-books/blob/master/LICENSE) dieses Repositorys. diff --git a/CONTRIBUTING-el.md b/CONTRIBUTING-el.md index 536c08ccb02a0..fe5a8356cee73 100644 --- a/CONTRIBUTING-el.md +++ b/CONTRIBUTING-el.md @@ -1,4 +1,4 @@ -*Διαβάστε το σε διαφορετικές γλώσσες: [Deutsch](CONTRIBUTING-de.md), [Français](CONTRIBUTING-fr.md), [English](CONTRIBUTING.md), [Español](CONTRIBUTING-es.md), **ελληνικά**, [Indonesia](CONTRIBUTING-id.md),[简体中文](CONTRIBUTING-zh.md), [繁體中文](CONTRIBUTING-zh_TW.md), [Português (BR)](CONTRIBUTING-pt_BR.md), [فارسی](CONTRIBUTING-fa_IR.md), [Tiếng Việt](CONTRIBUTING-vn.md), [Русский](CONTRIBUTING-ru.md).* +*Διαβάστε το σε διαφορετικές γλώσσες: [Deutsch](CONTRIBUTING-de.md), [Français](CONTRIBUTING-fr.md), [English](CONTRIBUTING.md), [Español](CONTRIBUTING-es.md), **ελληνικά**, [Indonesia](CONTRIBUTING-id.md),[简体中文](CONTRIBUTING-zh.md), [繁體中文](CONTRIBUTING-zh_TW.md), [Português (BR)](CONTRIBUTING-pt_BR.md), [فارسی](CONTRIBUTING-fa_IR.md), [Tiếng Việt](CONTRIBUTING-vn.md), [Русский](CONTRIBUTING-ru.md), [한국어](CONTRIBUTING-ko.md).* diff --git a/CONTRIBUTING-es.md b/CONTRIBUTING-es.md index 736df430f960e..32ec808f52a51 100644 --- a/CONTRIBUTING-es.md +++ b/CONTRIBUTING-es.md @@ -1,4 +1,4 @@ -*Lea esto en otros idiomas: [Deutsch](CONTRIBUTING-de.md), [English](CONTRIBUTING.md), [Français](CONTRIBUTING-fr.md), [简体中文](CONTRIBUTING-zh.md), [繁體中文](CONTRIBUTING-zh_TW.md), [فارسی](CONTRIBUTING-fa_IR.md), [Tiếng Việt](CONTRIBUTING-vn.md), [Русский](CONTRIBUTING-ru.md), [Português Brasileiro](CONTRIBUTING-pt_BR.md).* +*Lea esto en otros idiomas: [Deutsch](CONTRIBUTING-de.md), [English](CONTRIBUTING.md), [Français](CONTRIBUTING-fr.md), [简体中文](CONTRIBUTING-zh.md), [繁體中文](CONTRIBUTING-zh_TW.md), [فارسی](CONTRIBUTING-fa_IR.md), [Tiếng Việt](CONTRIBUTING-vn.md), [Русский](CONTRIBUTING-ru.md), [Português Brasileiro](CONTRIBUTING-pt_BR.md), [한국어](CONTRIBUTING-ko.md).* ## Acuerdo de Licencia diff --git a/CONTRIBUTING-fa_IR.md b/CONTRIBUTING-fa_IR.md index 51e0a372b6179..db6b0605fb0d5 100644 --- a/CONTRIBUTING-fa_IR.md +++ b/CONTRIBUTING-fa_IR.md @@ -1,4 +1,4 @@ -*این متن را در زبان‌های دیگر بخوانید: [Deutsch](CONTRIBUTING-de.md), [English](CONTRIBUTING.md), [Français](CONTRIBUTING-fr.md), [Español](CONTRIBUTING-es.md), [简体中文](CONTRIBUTING-zh.md), [繁體中文](CONTRIBUTING-zh_TW.md), [Tiếng Việt](CONTRIBUTING-vn.md), [Русский](CONTRIBUTING-ru.md), [Português Brasileiro](CONTRIBUTING-pt_BR.md).* +*این متن را در زبان‌های دیگر بخوانید: [Deutsch](CONTRIBUTING-de.md), [English](CONTRIBUTING.md), [Français](CONTRIBUTING-fr.md), [Español](CONTRIBUTING-es.md), [简体中文](CONTRIBUTING-zh.md), [繁體中文](CONTRIBUTING-zh_TW.md), [Tiếng Việt](CONTRIBUTING-vn.md), [Русский](CONTRIBUTING-ru.md), [Português Brasileiro](CONTRIBUTING-pt_BR.md), [한국어](CONTRIBUTING-ko.md).*
## توافقنامه‌ی مجوز همکاری diff --git a/CONTRIBUTING-fil.md b/CONTRIBUTING-fil.md index ffb11595eb3e5..d11e7c689ad5f 100644 --- a/CONTRIBUTING-fil.md +++ b/CONTRIBUTING-fil.md @@ -1,4 +1,4 @@ -*Basahin ito sa ibang mga wika: [Deutsch](CONTRIBUTING-de.md), [Français](CONTRIBUTING-fr.md), **Filipino**, [Español](CONTRIBUTING-es.md), [English](CONTRIBUTING.md), [Indonesia](CONTRIBUTING-id.md),[简体中文](CONTRIBUTING-zh.md), [繁體中文](CONTRIBUTING-zh_TW.md), [Português (BR)](CONTRIBUTING-pt_BR.md), [فارسی](CONTRIBUTING-fa_IR.md), [Tiếng Việt](CONTRIBUTING-vn.md), [Русский](CONTRIBUTING-ru.md).* +*Basahin ito sa ibang mga wika: [Deutsch](CONTRIBUTING-de.md), [Français](CONTRIBUTING-fr.md), **Filipino**, [Español](CONTRIBUTING-es.md), [English](CONTRIBUTING.md), [Indonesia](CONTRIBUTING-id.md),[简体中文](CONTRIBUTING-zh.md), [繁體中文](CONTRIBUTING-zh_TW.md), [Português (BR)](CONTRIBUTING-pt_BR.md), [فارسی](CONTRIBUTING-fa_IR.md), [Tiếng Việt](CONTRIBUTING-vn.md), [Русский](CONTRIBUTING-ru.md), [한국어](CONTRIBUTING-ko.md).* ## Kasunduan sa Lisensya ng Contributor Sa pamamagitan ng pag-aambag sumasang-ayon ka sa [LICENSE](https://github.com/EbookFoundation/free-programming-books/blob/master/LICENSE) ng repositoryong ito. diff --git a/CONTRIBUTING-fr.md b/CONTRIBUTING-fr.md index 97a33b582621d..ffb096bedbfe9 100644 --- a/CONTRIBUTING-fr.md +++ b/CONTRIBUTING-fr.md @@ -1,4 +1,4 @@ -*Lisez ceci dans d'autres langues: [Deutsch](CONTRIBUTING-de.md), [English](CONTRIBUTING.md), [Español](CONTRIBUTING-es.md), [简体中文](CONTRIBUTING-zh.md), [繁體中文](CONTRIBUTING-zh_TW.md), [فارسی](CONTRIBUTING-fa_IR.md), [Tiếng Việt](CONTRIBUTING-vn.md), [Русский](CONTRIBUTING-ru.md), [Português Brasileiro](CONTRIBUTING-pt_BR.md).* +*Lisez ceci dans d'autres langues: [Deutsch](CONTRIBUTING-de.md), [English](CONTRIBUTING.md), [Español](CONTRIBUTING-es.md), [简体中文](CONTRIBUTING-zh.md), [繁體中文](CONTRIBUTING-zh_TW.md), [فارسی](CONTRIBUTING-fa_IR.md), [Tiếng Việt](CONTRIBUTING-vn.md), [Русский](CONTRIBUTING-ru.md), [Português Brasileiro](CONTRIBUTING-pt_BR.md), [한국어](CONTRIBUTING-ko.md).* ## Contrat de Licence des Contributeurs En contribuant, vous acceptez la [LICENCE](https://github.com/ElivreFoundation/free-programming-livres/blob/master/LICENSE) de ce repositoire. diff --git a/CONTRIBUTING-id.md b/CONTRIBUTING-id.md index b013b6a88449f..e87f0852d902a 100644 --- a/CONTRIBUTING-id.md +++ b/CONTRIBUTING-id.md @@ -1,4 +1,4 @@ -*Instruksi ini dalam bahasa lain: [Deutsch](CONTRIBUTING-de.md), [English](CONTRIBUTING.md),[Español](CONTRIBUTING-es.md), [Français](CONTRIBUTING-fr.md), [简体中文](CONTRIBUTING-zh.md), [繁體中文](CONTRIBUTING-zh_TW.md), [فارسی](CONTRIBUTING-fa_IR.md), [Tiếng Việt](CONTRIBUTING-vn.md), [Русский](CONTRIBUTING-ru.md), [Português Brasileiro](CONTRIBUTING-pt_BR.md).* +*Instruksi ini dalam bahasa lain: [Deutsch](CONTRIBUTING-de.md), [English](CONTRIBUTING.md),[Español](CONTRIBUTING-es.md), [Français](CONTRIBUTING-fr.md), [简体中文](CONTRIBUTING-zh.md), [繁體中文](CONTRIBUTING-zh_TW.md), [فارسی](CONTRIBUTING-fa_IR.md), [Tiếng Việt](CONTRIBUTING-vn.md), [Русский](CONTRIBUTING-ru.md), [Português Brasileiro](CONTRIBUTING-pt_BR.md), [한국어](CONTRIBUTING-ko.md).* ## Perjanjian lisensi kontributor Dengan kerja sama Anda, Anda menerima [lisensi](https://github.com/EbookFoundation/free-programming-books/blob/master/LICENSE) dari repositori ini. diff --git a/CONTRIBUTING-it.md b/CONTRIBUTING-it.md index 3bdc4e1861930..0ef624dabe7cc 100644 --- a/CONTRIBUTING-it.md +++ b/CONTRIBUTING-it.md @@ -1,4 +1,4 @@ -*Leggilo in altre lingue: [Deutsch](CONTRIBUTING-de.md), [English](CONTRIBUTING.md), [Español](CONTRIBUTING-es.md), [Français](CONTRIBUTING-fr.md), **Italiano**, [简体中文](CONTRIBUTING-zh.md), [繁體中文](CONTRIBUTING-zh_TW.md), [فارسی](CONTRIBUTING-fa_IR.md), [Tiếng Việt](CONTRIBUTING-vn.md), [Русский](CONTRIBUTING-ru.md), [Português Brasileiro](CONTRIBUTING-pt_BR.md).* +*Leggilo in altre lingue: [Deutsch](CONTRIBUTING-de.md), [English](CONTRIBUTING.md), [Español](CONTRIBUTING-es.md), [Français](CONTRIBUTING-fr.md), **Italiano**, [简体中文](CONTRIBUTING-zh.md), [繁體中文](CONTRIBUTING-zh_TW.md), [فارسی](CONTRIBUTING-fa_IR.md), [Tiếng Việt](CONTRIBUTING-vn.md), [Русский](CONTRIBUTING-ru.md), [Português Brasileiro](CONTRIBUTING-pt_BR.md), [한국어](CONTRIBUTING-ko.md).* ## Accordo di Licenza Contribuendo tu accetti alla [LICENZA](https://github.com/EbookFoundation/free-programming-books/blob/master/LICENSE) di questa repository. diff --git a/CONTRIBUTING-pt_BR.md b/CONTRIBUTING-pt_BR.md index 6582f6f90fa5e..7acaedc0f4fc7 100644 --- a/CONTRIBUTING-pt_BR.md +++ b/CONTRIBUTING-pt_BR.md @@ -1,4 +1,4 @@ -*Leia em outros idiomas: [Deutsch](CONTRIBUTING-de.md), [Français](CONTRIBUTING-fr.md), [Español](CONTRIBUTING-es.md), [Indonesia](CONTRIBUTING-id.md),[简体中文](CONTRIBUTING-zh.md), [繁體中文](CONTRIBUTING-zh_TW.md), [فارسی](CONTRIBUTING-fa_IR.md), [Tiếng Việt](CONTRIBUTING-vn.md), [Русский](CONTRIBUTING-ru.md).* +*Leia em outros idiomas: [Deutsch](CONTRIBUTING-de.md), [Français](CONTRIBUTING-fr.md), [Español](CONTRIBUTING-es.md), [Indonesia](CONTRIBUTING-id.md),[简体中文](CONTRIBUTING-zh.md), [繁體中文](CONTRIBUTING-zh_TW.md), [فارسی](CONTRIBUTING-fa_IR.md), [Tiếng Việt](CONTRIBUTING-vn.md), [Русский](CONTRIBUTING-ru.md), [한국어](CONTRIBUTING-ko.md).* ## Acordo de Licença do Contribuidor Ao contribuir você concorda com a [LICENSE](https://github.com/EbookFoundation/free-programming-books/blob/master/LICENSE) deste repositório. diff --git a/CONTRIBUTING-ru.md b/CONTRIBUTING-ru.md index 6dba5203cd477..2fd6321a57991 100644 --- a/CONTRIBUTING-ru.md +++ b/CONTRIBUTING-ru.md @@ -1,4 +1,4 @@ -*Доступно на других языках: [Deutsch](CONTRIBUTING-de.md), [English](CONTRIBUTING.md), [Français](CONTRIBUTING-fr.md), [Español](CONTRIBUTING-es.md), [简体中文](CONTRIBUTING-zh.md), [繁體中文](CONTRIBUTING-zh_TW.md), [فارسی](CONTRIBUTING-fa_IR.md), [Tiếng Việt](CONTRIBUTING-vn.md), [Português Brasileiro](CONTRIBUTING-pt_BR.md).* +*Доступно на других языках: [Deutsch](CONTRIBUTING-de.md), [English](CONTRIBUTING.md), [Français](CONTRIBUTING-fr.md), [Español](CONTRIBUTING-es.md), [简体中文](CONTRIBUTING-zh.md), [繁體中文](CONTRIBUTING-zh_TW.md), [فارسی](CONTRIBUTING-fa_IR.md), [Tiếng Việt](CONTRIBUTING-vn.md), [Português Brasileiro](CONTRIBUTING-pt_BR.md), [한국어](CONTRIBUTING-ko.md).* ## Лицензионное соглашение с участником diff --git a/CONTRIBUTING-vi.md b/CONTRIBUTING-vi.md index ff8a7f186899d..866f0e1164ca4 100644 --- a/CONTRIBUTING-vi.md +++ b/CONTRIBUTING-vi.md @@ -1,4 +1,4 @@ -*Đọc bằng ngôn ngữ khác: [Deutsch](CONTRIBUTING-de.md), [English](CONTRIBUTING.md), [Français](CONTRIBUTING-fr.md), [Español](CONTRIBUTING-es.md), [体中文](CONTRIBUTING-zh.md), [繁體中文](CONTRIBUTING-zh_TW.md), [فارسی](CONTRIBUTING-fa_IR.md), [Русский](CONTRIBUTING-ru.md), [Português Brasileiro](CONTRIBUTING-pt_BR.md).* +*Đọc bằng ngôn ngữ khác: [Deutsch](CONTRIBUTING-de.md), [English](CONTRIBUTING.md), [Français](CONTRIBUTING-fr.md), [Español](CONTRIBUTING-es.md), [体中文](CONTRIBUTING-zh.md), [繁體中文](CONTRIBUTING-zh_TW.md), [فارسی](CONTRIBUTING-fa_IR.md), [Русский](CONTRIBUTING-ru.md), [Português Brasileiro](CONTRIBUTING-pt_BR.md), [한국어](CONTRIBUTING-ko.md).* Bản dịch Tiếng Việt: diff --git a/CONTRIBUTING-zh.md b/CONTRIBUTING-zh.md index 5ccd1bfa89590..d1a8d99707f66 100644 --- a/CONTRIBUTING-zh.md +++ b/CONTRIBUTING-zh.md @@ -1,4 +1,4 @@ -*阅读本文的其他语言版本：[Deutsch](CONTRIBUTING-de.md), [English](CONTRIBUTING.md), [Français](CONTRIBUTING-fr.md), [Español](CONTRIBUTING-es.md), [繁體中文](CONTRIBUTING-zh_TW.md), [فارسی](CONTRIBUTING-fa_IR.md), [Tiếng Việt](CONTRIBUTING-vn.md), [Русский](CONTRIBUTING-ru.md), [Português Brasileiro](CONTRIBUTING-pt_BR.md).* +*阅读本文的其他语言版本：[Deutsch](CONTRIBUTING-de.md), [English](CONTRIBUTING.md), [Français](CONTRIBUTING-fr.md), [Español](CONTRIBUTING-es.md), [繁體中文](CONTRIBUTING-zh_TW.md), [فارسی](CONTRIBUTING-fa_IR.md), [Tiếng Việt](CONTRIBUTING-vn.md), [Русский](CONTRIBUTING-ru.md), [Português Brasileiro](CONTRIBUTING-pt_BR.md), [한국어](CONTRIBUTING-ko.md).* ## 贡献者许可协议 diff --git a/CONTRIBUTING-zh_TW.md b/CONTRIBUTING-zh_TW.md index 4812e92a48594..0e1f8b151b46b 100644 --- a/CONTRIBUTING-zh_TW.md +++ b/CONTRIBUTING-zh_TW.md @@ -1,4 +1,4 @@ -*閱讀其他語言版本的文件：[Deutsch](CONTRIBUTING-de.md), [English](CONTRIBUTING.md), [Français](CONTRIBUTING-fr.md), [Español](CONTRIBUTING-es.md), [简体中文](CONTRIBUTING-zh.md), [فارسی](CONTRIBUTING-fa_IR.md), [Tiếng Việt](CONTRIBUTING-vn.md), [Русский](CONTRIBUTING-ru.md), [Português Brasileiro](CONTRIBUTING-pt_BR.md).* +*閱讀其他語言版本的文件：[Deutsch](CONTRIBUTING-de.md), [English](CONTRIBUTING.md), [Français](CONTRIBUTING-fr.md), [Español](CONTRIBUTING-es.md), [简体中文](CONTRIBUTING-zh.md), [فارسی](CONTRIBUTING-fa_IR.md), [Tiếng Việt](CONTRIBUTING-vn.md), [Русский](CONTRIBUTING-ru.md), [Português Brasileiro](CONTRIBUTING-pt_BR.md), [한국어](CONTRIBUTING-ko.md).* ## 貢獻者許可協議 diff --git a/HOWTO-ar.md b/HOWTO-ar.md index 1ce49b5ee93e2..cf7aa16a830fd 100644 --- a/HOWTO-ar.md +++ b/HOWTO-ar.md @@ -1,4 +1,4 @@ -إقرأ هذا بلغات أخرى: [English](HOWTO.md), [Français](HOWTO-fr.md), [Español](HOWTO-es.md), [简体中文](HOWTO-zh.md), [हिन्दी](HOWTO-hi.md), [繁體中文](HOWTO-zh_TW.md), [Português (BR)](HOWTO-pt_BR.md), [فارسی](HOWTO-fa_IR.md), [Русский](HOWTO-ru.md), [Deutsch](HOWTO-de.md), [Bahasa Indonesia](HOWTO-id.md), [Українська](HOWTO-uk.md). +إقرأ هذا بلغات أخرى: [English](HOWTO.md), [Français](HOWTO-fr.md), [Español](HOWTO-es.md), [简体中文](HOWTO-zh.md), [हिन्दी](HOWTO-hi.md), [繁體中文](HOWTO-zh_TW.md), [Português (BR)](HOWTO-pt_BR.md), [فارسی](HOWTO-fa_IR.md), [Русский](HOWTO-ru.md), [Deutsch](HOWTO-de.md), [Bahasa Indonesia](HOWTO-id.md), [Українська](HOWTO-uk.md), [한국어](HOWTO-ko.md). مرحبا بكم في *!Free-Programming-Books* نرحّب بجميع المساهمين الجدد؛ ونرحب أيضا بهؤلاء الذين يريدون تقديم أول بولّ ريكويست لهم علي جيت هبّ. إن كنت واحدا منهم، فإليك بعض المصادر التي ربما تساعدك: diff --git a/HOWTO-el.md b/HOWTO-el.md index 5dc5817c51825..23d140ffec76f 100644 --- a/HOWTO-el.md +++ b/HOWTO-el.md @@ -1,4 +1,4 @@ -Διαβάστε το σε διαφορετικές γλώσσες: [Français](HOWTO-fr.md), [English](HOWTO.md), [Español](HOWTO-es.md), **ελληνικά**, [简体中文](HOWTO-zh.md), [हिन्दी](HOWTO-hi.md), [繁體中文](HOWTO-zh_TW.md), [Português (BR)](HOWTO-pt_BR.md), [فارسی](HOWTO-fa_IR.md), [Русский](HOWTO-ru.md), [Deutsch](HOWTO-de.md), [Bahasa Indonesia](HOWTO-id.md), [Tiếng Việt](HOWTO-vi.md), [عربي](HOWTO-ar.md). +Διαβάστε το σε διαφορετικές γλώσσες: [Français](HOWTO-fr.md), [English](HOWTO.md), [Español](HOWTO-es.md), **ελληνικά**, [简体中文](HOWTO-zh.md), [हिन्दी](HOWTO-hi.md), [繁體中文](HOWTO-zh_TW.md), [Português (BR)](HOWTO-pt_BR.md), [فارسی](HOWTO-fa_IR.md), [Русский](HOWTO-ru.md), [Deutsch](HOWTO-de.md), [Bahasa Indonesia](HOWTO-id.md), [Tiếng Việt](HOWTO-vi.md), [عربي](HOWTO-ar.md), [한국어](HOWTO-ko.md). Καλώς ήλθατε στο Free-Programming-Books! Καλωσορίζουμε τους νέους συνεισφέροντες· ακόμα και αυτούς που κάνουν το πρώτο τους pull request (PR) στο Github. Αν είστε ένας από αυτούς, ορίστε λίγο υλικό που μπορεί να βοηθήσει: diff --git a/HOWTO-fil.md b/HOWTO-fil.md index 80389137c5b76..2f330e8b79c82 100644 --- a/HOWTO-fil.md +++ b/HOWTO-fil.md @@ -1,4 +1,4 @@ -Basahin ito sa ibang mga wika: [English](HOWTO.md), [Français](HOWTO-fr.md), [Español](HOWTO-es.md), **Filipino**, [简体中文](HOWTO-zh.md), [हिन्दी](HOWTO-hi.md), [繁體中文](HOWTO-zh_TW.md), [Português (BR)](HOWTO-pt_BR.md), [فارسی](HOWTO-fa_IR.md), [Русский](HOWTO-ru.md), [Deutsch](HOWTO-de.md), [Bahasa Indonesia](HOWTO-id.md), [Tiếng Việt](HOWTO-vi.md), [عربي](HOWTO-ar.md). +Basahin ito sa ibang mga wika: [English](HOWTO.md), [Français](HOWTO-fr.md), [Español](HOWTO-es.md), **Filipino**, [简体中文](HOWTO-zh.md), [हिन्दी](HOWTO-hi.md), [繁體中文](HOWTO-zh_TW.md), [Português (BR)](HOWTO-pt_BR.md), [فارسی](HOWTO-fa_IR.md), [Русский](HOWTO-ru.md), [Deutsch](HOWTO-de.md), [Bahasa Indonesia](HOWTO-id.md), [Tiếng Việt](HOWTO-vi.md), [عربي](HOWTO-ar.md), [한국어](HOWTO-ko.md). Maligayang pagdating sa Free-Programming-Books! Tinatanggap namin ang mga bagong kontribyutor; kahit na ang mga gumagawa ng kanilang pinakaunang pull request sa Github. Kung isa ka sa mga iyon, narito ang ilang mapagkukunan na maaaring makatulong: diff --git a/HOWTO-km.md b/HOWTO-km.md index 0811a5603dbb8..b425eab734717 100644 --- a/HOWTO-km.md +++ b/HOWTO-km.md @@ -1,4 +1,4 @@ -អានជាភាសាផ្សេងៗ: [Français](HOWTO-fr.md), [Español](HOWTO-es.md), [简体中文](HOWTO-zh.md), [हिन्दी](HOWTO-hi.md), [繁體中文](HOWTO-zh_TW.md), [Português (BR)](HOWTO-pt_BR.md), [فارسی](HOWTO-fa_IR.md), [Русский](HOWTO-ru.md), [Deutsch](HOWTO-de.md), [Bahasa Indonesia](HOWTO-id.md), [Tiếng Việt](HOWTO-vi.md), [عربي](HOWTO-ar.md), [Українська](HOWTO-uk.md). +អានជាភាសាផ្សេងៗ: [Français](HOWTO-fr.md), [Español](HOWTO-es.md), [简体中文](HOWTO-zh.md), [हिन्दी](HOWTO-hi.md), [繁體中文](HOWTO-zh_TW.md), [Português (BR)](HOWTO-pt_BR.md), [فارسی](HOWTO-fa_IR.md), [Русский](HOWTO-ru.md), [Deutsch](HOWTO-de.md), [Bahasa Indonesia](HOWTO-id.md), [Tiếng Việt](HOWTO-vi.md), [عربي](HOWTO-ar.md), [Українська](HOWTO-uk.md), [한국어](HOWTO-ko.md). ស្វាគមន៍មកកាន់ Free-Programming-Books! យើងរីករាយ ទទូល contributors ថ្មីៗ; ទោះបីវាជាការpull request ជាលើកដំបូងរបស់អ្នកក៏ដោយ. បើអ្នកទើបតែចាប់ផ្តើម contibute ដំបូង , ធនធានខាងក្រោមអាចជួយអ្នកបាន: diff --git a/HOWTO-ko.md b/HOWTO-ko.md index 13f222bf32b94..f6c52a32eef66 100644 --- a/HOWTO-ko.md +++ b/HOWTO-ko.md @@ -1,4 +1,4 @@ -다른언어: [English](HOWTO.md), [Français](HOWTO-fr.md), [Español](HOWTO-es.md), [简体中文](HOWTO-zh.md), [हिन्दी](HOWTO-hi.md), [繁體中文](HOWTO-zh_TW.md), [Português (BR)](HOWTO-pt_BR.md), [فارسی](HOWTO-fa_IR.md), [Русский](HOWTO-ru.md), [босански](HOWTO-bs.md), [Deutsch](HOWTO-de.md), [Tiếng Việt](HOWTO-vi.md), [عربي](HOWTO-ar.md), [Українська](HOWTO-uk.md), [한국어](HOWTO-ko.md). +다른언어: [English](HOWTO.md), [Français](HOWTO-fr.md), [Español](HOWTO-es.md), [简体中文](HOWTO-zh.md), [हिन्दी](HOWTO-hi.md), [繁體中文](HOWTO-zh_TW.md), [Português (BR)](HOWTO-pt_BR.md), [فارسی](HOWTO-fa_IR.md), [Русский](HOWTO-ru.md), [босански](HOWTO-bs.md), [Deutsch](HOWTO-de.md), [Tiếng Việt](HOWTO-vi.md), [عربي](HOWTO-ar.md), [Українська](HOWTO-uk.md). Free-Programming-Books 에 오신 것을 환영합니다! 우리는 Github 에 첫 Pull-request 를 분들을 포함한 새로운 기여자들을 환영합니다. 다음 리소스들은 당신에게 도움이 될 수 있습니다: diff --git a/HOWTO-pl.md b/HOWTO-pl.md index 5b483cb30597f..429b0b3bee781 100644 --- a/HOWTO-pl.md +++ b/HOWTO-pl.md @@ -1,4 +1,4 @@ -Przeczytaj to w innych językach: [Français](HOWTO-fr.md), [Español](HOWTO-es.md), [简体中文](HOWTO-zh.md), [हिन्दी](HOWTO-hi.md), [繁體中文](HOWTO-zh_TW.md), [Português (BR)](HOWTO-pt_BR.md), [فارسی](HOWTO-fa_IR.md), [Русский](HOWTO-ru.md), [Deutsch](HOWTO-de.md), [Bahasa Indonesia](HOWTO-id.md), [Tiếng Việt](HOWTO-vi.md), [عربي](HOWTO-ar.md), [Українська](HOWTO-uk.md). +Przeczytaj to w innych językach: [Français](HOWTO-fr.md), [Español](HOWTO-es.md), [简体中文](HOWTO-zh.md), [हिन्दी](HOWTO-hi.md), [繁體中文](HOWTO-zh_TW.md), [Português (BR)](HOWTO-pt_BR.md), [فارسی](HOWTO-fa_IR.md), [Русский](HOWTO-ru.md), [Deutsch](HOWTO-de.md), [Bahasa Indonesia](HOWTO-id.md), [Tiếng Việt](HOWTO-vi.md), [عربي](HOWTO-ar.md), [Українська](HOWTO-uk.md), [한국어](HOWTO-ko.md). Witamy w *Free-Programming-Books*! Witamy nowych współtwórców; nawet tych, którzy robią swoje pierwsze żądanie ściągnięcia na Github. Jeśli jesteś jednym z nich, oto kilka zasobów, które mogą Ci pomóc: diff --git a/HOWTO-sl.md b/HOWTO-sl.md index 9ee9f95f5d62e..37ba17f9c2f03 100644 --- a/HOWTO-sl.md +++ b/HOWTO-sl.md @@ -1,4 +1,4 @@ -Preberite to v drugih jezikih: [Français](HOWTO-fr.md), [Español](HOWTO-es.md), [简体中文](HOWTO-zh.md), [हिन्दी](HOWTO-hi.md), [繁體中文](HOWTO-zh_TW.md), [Português (BR)](HOWTO-pt_BR.md), [فارسی](HOWTO-fa_IR.md), [Русский](HOWTO-ru.md), [Deutsch](HOWTO-de.md), [Bahasa Indonesia](HOWTO-id.md), [Tiếng Việt](HOWTO-vi.md), [عربي](HOWTO-ar.md), [Українська](HOWTO-uk.md). +Preberite to v drugih jezikih: [Français](HOWTO-fr.md), [Español](HOWTO-es.md), [简体中文](HOWTO-zh.md), [हिन्दी](HOWTO-hi.md), [繁體中文](HOWTO-zh_TW.md), [Português (BR)](HOWTO-pt_BR.md), [فارسی](HOWTO-fa_IR.md), [Русский](HOWTO-ru.md), [Deutsch](HOWTO-de.md), [Bahasa Indonesia](HOWTO-id.md), [Tiếng Việt](HOWTO-vi.md), [عربي](HOWTO-ar.md), [Українська](HOWTO-uk.md), [한국어](HOWTO-ko.md). Dobrodošli v zbirki Free-Programming-Books! Lepo pozdravljeni vsi novi programerji - tudi tisti, ki boste na Githubu ustvarili vaš prvi zahtevek potega (pull-request). Če ste eden izmed njih, vam pri tem lahko pomaga nekaj virov: diff --git a/HOWTO-th.md b/HOWTO-th.md index d4344bb0f9498..bd084afabb938 100644 --- a/HOWTO-th.md +++ b/HOWTO-th.md @@ -1,4 +1,4 @@ -อ่านไฟล์นี้ในภาษาอื่น: [English](HOWTO.md), [Français](HOWTO-fr.md), [Español](HOWTO-es.md), [简体中文](HOWTO-zh.md), [हिन्दी](HOWTO-hi.md), [繁體中文](HOWTO-zh_TW.md), [Português (BR)](HOWTO-pt_BR.md), [فارسی](HOWTO-fa_IR.md), [Русский](HOWTO-ru.md), [Deutsch](HOWTO-de.md), [Bahasa Indonesia](HOWTO-id.md), [Tiếng Việt](HOWTO-vi.md), [عربي](HOWTO-ar.md), **ไทย**. +อ่านไฟล์นี้ในภาษาอื่น: [English](HOWTO.md), [Français](HOWTO-fr.md), [Español](HOWTO-es.md), [简体中文](HOWTO-zh.md), [हिन्दी](HOWTO-hi.md), [繁體中文](HOWTO-zh_TW.md), [Português (BR)](HOWTO-pt_BR.md), [فارسی](HOWTO-fa_IR.md), [Русский](HOWTO-ru.md), [Deutsch](HOWTO-de.md), [Bahasa Indonesia](HOWTO-id.md), [Tiếng Việt](HOWTO-vi.md), [عربي](HOWTO-ar.md), [한국어](HOWTO-ko.md), **ไทย**. ขอต้อนรับเข้าสู่ Free-Programming-Books! พวกเราขอต้อนรับ contributors ใหม่ทุกคน แม้ว่าคุณพึ่งจะเคยสร้าง pull request เป็นครั้งแรกบน Github หากคุณคือหนึ่งในนั้น ด้านล่างนี้คือแหล่งข้อมูลที่อาจจะเป็นประโยชน์: diff --git a/HOWTO-uk.md b/HOWTO-uk.md index 9d3aa3f1ecfff..c51bcbee2e6c1 100644 --- a/HOWTO-uk.md +++ b/HOWTO-uk.md @@ -1,4 +1,4 @@ -Прочитати іншими мовами: [Français](HOWTO-fr.md), [Español](HOWTO-es.md), [简体中文](HOWTO-zh.md), [हिन्दी](HOWTO-hi.md), [繁體中文](HOWTO-zh_TW.md), [Português (BR)](HOWTO-pt_BR.md), [فارسی](HOWTO-fa_IR.md), [Русский](HOWTO-ru.md), [Deutsch](HOWTO-de.md), [Bahasa Indonesia](HOWTO-id.md), [Tiếng Việt](HOWTO-vi.md), [عربي](HOWTO-ar.md). +Прочитати іншими мовами: [Français](HOWTO-fr.md), [Español](HOWTO-es.md), [简体中文](HOWTO-zh.md), [हिन्दी](HOWTO-hi.md), [繁體中文](HOWTO-zh_TW.md), [Português (BR)](HOWTO-pt_BR.md), [فارسی](HOWTO-fa_IR.md), [Русский](HOWTO-ru.md), [Deutsch](HOWTO-de.md), [Bahasa Indonesia](HOWTO-id.md), [Tiếng Việt](HOWTO-vi.md), [عربي](HOWTO-ar.md), [한국어](HOWTO-ko.md). Ласкаво просимо до Free-Programming-Books! Вітаємо нових учасників, навіть тих, хто робить свій перший pull request на Github. Якщо Ви один із них, ці ресурси можуть Вам допомогти: diff --git a/HOWTO-vi.md b/HOWTO-vi.md index 26fc8877f706f..e302f21d78ff8 100644 --- a/HOWTO-vi.md +++ b/HOWTO-vi.md @@ -1,4 +1,4 @@ -Đọc tài liệu này bằng các ngôn ngữ khác: [English](HOWTO.md), [Français](HOWTO-fr.md), [Español](HOWTO-es.md), [简体中文](HOWTO-zh.md), [हिन्दी](HOWTO-hi.md), [繁體中文](HOWTO-zh_TW.md), [Português (BR)](HOWTO-pt_BR.md), [فارسی](HOWTO-fa_IR.md), [Русский](HOWTO-ru.md), [Deutsch](HOWTO-de.md), [Bahasa Indonesia](HOWTO-id.md), [عربي](HOWTO-ar.md), [Українська](HOWTO-uk.md). +Đọc tài liệu này bằng các ngôn ngữ khác: [English](HOWTO.md), [Français](HOWTO-fr.md), [Español](HOWTO-es.md), [简体中文](HOWTO-zh.md), [हिन्दी](HOWTO-hi.md), [繁體中文](HOWTO-zh_TW.md), [Português (BR)](HOWTO-pt_BR.md), [فارسی](HOWTO-fa_IR.md), [Русский](HOWTO-ru.md), [Deutsch](HOWTO-de.md), [Bahasa Indonesia](HOWTO-id.md), [عربي](HOWTO-ar.md), [Українська](HOWTO-uk.md), [한국어](HOWTO-ko.md). Chào mừng tới Free-Programming-Books! Chúng tôi chào đón những người đóng góp mới, kể cả khi những người đóng góp lần đầu thực hiện trên Github. Nếu bạn là một trong số họ, đây là một số nguồn có thể giúp: