From aeba28b7ab903a323be82bf9b5c91ebdb55c841c Mon Sep 17 00:00:00 2001 From: Minjun Kim Date: Tue, 31 Mar 2020 17:41:26 +0200 Subject: [PATCH 1/6] create ko directory and empty installation.md file --- developer_docs/ko/installation.md | 1 + 1 file changed, 1 insertion(+) create mode 100644 developer_docs/ko/installation.md diff --git a/developer_docs/ko/installation.md b/developer_docs/ko/installation.md new file mode 100644 index 0000000000..8b13789179 --- /dev/null +++ b/developer_docs/ko/installation.md @@ -0,0 +1 @@ + From f93e5edbb17cc89be8d61504a769354f08f1cde2 Mon Sep 17 00:00:00 2001 From: mjaything <13192500+mjaything@users.noreply.github.com> Date: Tue, 31 Mar 2020 18:06:18 +0200 Subject: [PATCH 2/6] Add Korean Translation of installation.md --- developer_docs/ko/installation.md | 77 +++++++++++++++++++++++++++++++ 1 file changed, 77 insertions(+) diff --git a/developer_docs/ko/installation.md b/developer_docs/ko/installation.md index 8b13789179..15abf29fc9 100644 --- a/developer_docs/ko/installation.md +++ b/developer_docs/ko/installation.md @@ -1 +1,78 @@ +# 설치 +다음의 안내를 따라 본 프로젝트에 코드를 기여하기 위해 필요한 개발 환경을 설정해주십시오. + +## 수동 설치 + +_주의_: 다음의 설치 단계들은 유닉스 계열의 쉘을 이용한다는 가정이 깔려 있습니다. 만약 윈도우를 사용하고 계신다면 `cp` 대신 `copy`를 사용해야 할 것입니다. + +1. Node.js를 설치하십시오. [nvm](https://github.com/nvm-sh/nvm)을 통해 설치하는 걸 권장드립니다. 혹은 Node.js 웹사이트를 통해 [node.js](https://nodejs.org/download/release/v12.16.1/) 버전 12.16.1을 설치하는 것도 가능합니다. +2. [p5.js 웹 에디터 저장소](https://github.com/processing/p5.js-web-editor)를 여러분의 깃허브 계정에 [포크](https://help.github.com/articles/fork-a-repo)하십시오. +3. 포크한 깃허브 저장소를 여러분의 로컬 컴퓨터에 [클론](https://help.github.com/articles/cloning-a-repository/)하십시오. + + ``` + $ git clone https://github.com/YOUR_USERNAME/p5.js-web-editor.git + ``` + +4. nvm을 사용하신다면, $ nvm use 를 실행해 Node 버전을 12.16.1로 설정하십시오. +5. 프로젝트 폴더로 가서 npm을 이용해 필요한 모든 디펜던시들을 설치하십시오. + + ``` + $ cd p5.js-web-editor + $ npm install + ``` +6. MongoDB를 설치하고 잘 실행되는지 확인하십시오 + * [homebrew](http://brew.sh/)가 있는 맥 OSX:`brew tap mongodb/brew` 이후 `brew install mongodb-community` 그리고 `brew services start mongodb-community`로 서버를 시작하거나 다음의 설치 가이드를 살펴보십시오. [맥OS를 위한 설치 가이드](https://docs.mongodb.com/manual/tutorial/install-mongodb-on-os-x/) + * 윈도우와 리눅스: [MongoDB 설치](https://docs.mongodb.com/manual/installation/) +7. `$ cp .env.example .env` +8. (선택사항) 깃허브에 로그인 하고 싶을 경우 깃헙 ID를 더하는 등 특정한 행동을 가능하게 하고 싶을 경우 .env에 필수 키를 업데이트 하십시오. +9. `$ npm run fetch-examples` - 이는 p5라 불리는 유저로 예시 스케치를 다운로드 합니다. +10. `$ npm start` +11. 브라우저에서 [http://localhost:8000](http://localhost:8000)에 접속하십시오. +12. [리액트 개발자 도구](https://chrome.google.com/webstore/detail/react-developer-tools/fmkadmapgofadopljbjfkapdkoienihi?hl=en)를 설치하십시오. +13. `ctrl+h`로 리덕스 개발자 툴 열기와 닫기를, 그리고 `ctrl+w`로 이동시키기를 하십시오. + +## 도커 설치 + +_주의_: 다음의 설치 단계들은 유닉스 계열의 쉘을 이용한다는 가정이 깔려 있습니다. 만약 윈도우를 사용하고 계신다면 `cp` 대신 `copy`를 사용해야 할 것입니다. + +도커를 이용하면 Node, Mongo 등의 디펜던시들을 수동으로 설치할 필요 없이 완전하고 일관성 있는 개발 환경을 얻을 수 있게 됩니다. 또한 이는 같은 컴퓨터에서 다른 버전을 사용하는 다른 프로젝트로부터 디펜던시와 데이터를 분리시키는데에도 유용합니다. + +다만 이는 여러분의 컴퓨터의 상당한 용량을 차지한다는 점을 주의하십시오. 최소한 5GB의 여유 공간을 확보해두시기 바랍니다. + +1. 운영 체제에 도커를 설치하십시오. + * 맥: https://www.docker.com/docker-mac + * 윈도우: https://www.docker.com/docker-windows +2. 저장소를 클론하고 cd를 이용해 해당 저장소로 들어가십시오. +3. `$ docker-compose -f docker-compose-development.yml build` +4. `$ cp .env.example .env` +5. (선택사항) 깃허브에 로그인 하고 싶을 경우 깃헙 ID를 더하는 등 특정한 행동을 가능하게 하고 싶을 경우 .env에 필수 키를 업데이트 하십시오. +6. `$ docker-compose -f docker-compose-development.yml run --rm app npm run fetch-examples` + +이제, 언제든지 디펜던시와 함께 서버를 시작시키기를 원할 때면 다음을 실행하시면 됩니다: + +7. `$ docker-compose -f docker-compose-development.yml up` +8. 브라우저에서 [http://localhost:8000](http://localhost:8000)에 접속하십시오. + +실행되고 있는 도커 서버에서 터미널/쉘 열기(즉, `docker-compose up`이 실행된 이후): + +9. `$ docker-compose -f docker-compose-development.yml exec app bash -l` + +완전한 서버 환경이 실행되고 있지 않은 경우, 일회용 컨테이너 인스턴스를 런칭하고 전부 사용한 후에는 자동으로 삭제되도록 할 수 있습니다: + +10. `$ docker-compose -f docker-compose-development.yml run app --rm bash -l` + +## S3 버킷 환경 설정 + +애플리케이션 중 유저가 이미지, 비디오 등을 업로드 할 수 있도록 해주는 부분을 작업하지 않는 이상 이 부분은 필수 사항은 아니라는 점을 참고하십시오. 본 프로젝트에 사용될 S3 버킷을 설치하는 과정의 [요약본](https://gist.github.com/catarak/70c9301f0fd1ac2d6b58de03f61997e3)을 참고하십시오. + +만약 여러분의 S3 버킷이 미국 동부(북 버지니아) 지역(us-east-1)에 있다면, 해당 지역은 다른 지역과 달리 표준 명명 패턴을 따르지 않기 때문에 커스텀 URL 베이스를 설정해야 합니다. 다음을 environment/.env 파일에 추가해주십시오: + +`S3_BUCKET_URL_BASE=https://s3.amazonaws.com` + +커스텀 도메인 이름을 사용하기 위한 S3 버킷과 DNS 기록 환경을 설정했다면, 다음 변수를 이용해 커스텀 URL 베이스를 설정할 수도 있습니다: + +`S3_BUCKET_URL_BASE=https://files.mydomain.com` + +커스텀 도메인을 사용하는데에 필요한 더 많은 정보를 보기 위해선 다음의 문서 링크를 확인하십시오: +http://docs.aws.amazon.com/AmazonS3/latest/dev/VirtualHosting.html#VirtualHostingCustomURLs From 8e3d31ed43a5b5f78838706844d43dd073696d83 Mon Sep 17 00:00:00 2001 From: Minjun Kim Date: Thu, 9 Apr 2020 14:33:53 +0200 Subject: [PATCH 3/6] change location of installation.md --- translations/ko/README.md | 38 +++++++++++++++++++++++++++++++++ translations/ko/installation.md | 1 + 2 files changed, 39 insertions(+) create mode 100644 translations/ko/README.md create mode 100644 translations/ko/installation.md diff --git a/translations/ko/README.md b/translations/ko/README.md new file mode 100644 index 0000000000..9be60b7a4e --- /dev/null +++ b/translations/ko/README.md @@ -0,0 +1,38 @@ +# [p5.js 웹 에디터](https://editor.p5js.org) + +p5.js 웹 에디터는 예술가, 디자이너, 교육자, 초급자, 그 외에도 코딩을 배우고 싶어하는 모든 이들을 포함해 최대한 많은 사람들에게 코딩을 접근 가능하도록 만드는데에 초점을 맞춘 창의적 코딩을 위한 플랫폼입니다. 웹사이트만 열면 다운로드나 설정을 할 필요도 없이 곧바로 p5.js 스케치를 작성할 수 있습니다. 본 에디터는 제한적인 기능만을 제공하고 불필요한 장식을 없애는 등 단순함을 염두에 두고 만들어졌습니다. 우리는 이 에디터를 개발해나감에 있어서 커뮤니티의 의견에 귀 기울이고, 모든 변경 사항에 의도를 깃들일 수 있도록 노력하고 있습니다. 본 에디터는 무료이며 오픈 소스입니다. + +우리는 또한 커뮤니티에게 최대한 많은 주인 의식과 통제권을 드리고자 노력합니다. 여러분이 작성한 스케치를 다운로드해 로컬 환경에서 스케치를 편집하는 것도 가능하며, 다른 곳에 호스팅 하는 것 역시 가능합니다. 여러분은 자신만의 에디터 버전을 호스팅해 데이터에 대한 통제권을 지닐 수도 있습니다. + +## 커뮤니티 + +p5.js 커뮤니티에 처음 오셨나요? 그렇다면 먼저 저희의 [커뮤니티 성명서](https://p5js.org/community/)를 읽어주시기 바랍니다. + +## 행동 수칙 + +p5.js 웹 에디터의 모든 컨트리뷰터들은 다음의 [행동 수칙](./.github/CODE_OF_CONDUCT.md)을 따라야 합니다. 우리는 친근감 있고 안전한 커뮤니티를 만들고자 노력하고 있습니다! + +## 참여하기 + +p5.js 웹 에디터는 다수의 개인들에 의해 만들어진 협력 프로젝트이며, 여러분 역시 도움을 주실 수 있습니다. 모든 종류의 참여를 환영합니다! 더 자세한 사항을 위해서는 [기여 안내](./.github/CONTRIBUTING.md)를 확인하시기 바랍니다. + +개발자 분들은 코드 기여, 버그 수정, 문서화에 대한 세부 사항을 [개발자 문서](https://github.com/processing/p5.js-web-editor/blob/master/developer_docs/)에서 확인하시기 바랍니다. 코드 작성을 시작하기 위한 좋은 시작점은 [개발 안내](https://github.com/processing/p5.js-web-editor/blob/master/developer_docs/development.md)를 살펴보는 것입니다. + +## 이슈 + +p5.js 웹 에디터에서 버그를 발견하셨다면, [“이슈” 탭](https://github.com/processing/p5.js-web-editor/issues)에 해당 문제를 보고하실 수 있습니다. + +버그와 기능 요청은 각각에 알맞은 저장소에 보고해주시기 바랍니다: + +* p5.js 라이브러리와 p5.dom: [https://github.com/processing/p5.js/issues](https://github.com/processing/p5.js/issues) +* p5.accessibility: [https://github.com/processing/p5.accessibility/issues](https://github.com/processing/p5.accessibility/issues) +* p5.sound: [https://github.com/processing/p5.js-sound/issues](https://github.com/processing/p5.js-sound/issues) +* p5.js 웹사이트: [https://github.com/processing/p5.js-website/issues](https://github.com/processing/p5.js-website/issues) + +## 감사의 말 + +본 프로젝트는 [프로세싱 재단](https://processingfoundation.org/), [뉴욕대 ITP](https://tisch.nyu.edu/itp), [뉴욕시 교육부의 CS4All](http://cs4all.nyc/)에서 후원해주셨습니다. + +호스팅과 기술적 지원은 다음 단체들에서 해주셨습니다:
+ + diff --git a/translations/ko/installation.md b/translations/ko/installation.md new file mode 100644 index 0000000000..8b13789179 --- /dev/null +++ b/translations/ko/installation.md @@ -0,0 +1 @@ + From 18fc0fcf7e760c8377ef44f98552cf95fdf6d6ee Mon Sep 17 00:00:00 2001 From: Minjun Kim Date: Thu, 9 Apr 2020 14:35:56 +0200 Subject: [PATCH 4/6] remove ko directory from developer_docs directory --- developer_docs/ko/installation.md | 78 ------------------------------- 1 file changed, 78 deletions(-) delete mode 100644 developer_docs/ko/installation.md diff --git a/developer_docs/ko/installation.md b/developer_docs/ko/installation.md deleted file mode 100644 index 15abf29fc9..0000000000 --- a/developer_docs/ko/installation.md +++ /dev/null @@ -1,78 +0,0 @@ -# 설치 - -다음의 안내를 따라 본 프로젝트에 코드를 기여하기 위해 필요한 개발 환경을 설정해주십시오. - -## 수동 설치 - -_주의_: 다음의 설치 단계들은 유닉스 계열의 쉘을 이용한다는 가정이 깔려 있습니다. 만약 윈도우를 사용하고 계신다면 `cp` 대신 `copy`를 사용해야 할 것입니다. - -1. Node.js를 설치하십시오. [nvm](https://github.com/nvm-sh/nvm)을 통해 설치하는 걸 권장드립니다. 혹은 Node.js 웹사이트를 통해 [node.js](https://nodejs.org/download/release/v12.16.1/) 버전 12.16.1을 설치하는 것도 가능합니다. -2. [p5.js 웹 에디터 저장소](https://github.com/processing/p5.js-web-editor)를 여러분의 깃허브 계정에 [포크](https://help.github.com/articles/fork-a-repo)하십시오. -3. 포크한 깃허브 저장소를 여러분의 로컬 컴퓨터에 [클론](https://help.github.com/articles/cloning-a-repository/)하십시오. - - ``` - $ git clone https://github.com/YOUR_USERNAME/p5.js-web-editor.git - ``` - -4. nvm을 사용하신다면, $ nvm use 를 실행해 Node 버전을 12.16.1로 설정하십시오. -5. 프로젝트 폴더로 가서 npm을 이용해 필요한 모든 디펜던시들을 설치하십시오. - - ``` - $ cd p5.js-web-editor - $ npm install - ``` -6. MongoDB를 설치하고 잘 실행되는지 확인하십시오 - * [homebrew](http://brew.sh/)가 있는 맥 OSX:`brew tap mongodb/brew` 이후 `brew install mongodb-community` 그리고 `brew services start mongodb-community`로 서버를 시작하거나 다음의 설치 가이드를 살펴보십시오. [맥OS를 위한 설치 가이드](https://docs.mongodb.com/manual/tutorial/install-mongodb-on-os-x/) - * 윈도우와 리눅스: [MongoDB 설치](https://docs.mongodb.com/manual/installation/) -7. `$ cp .env.example .env` -8. (선택사항) 깃허브에 로그인 하고 싶을 경우 깃헙 ID를 더하는 등 특정한 행동을 가능하게 하고 싶을 경우 .env에 필수 키를 업데이트 하십시오. -9. `$ npm run fetch-examples` - 이는 p5라 불리는 유저로 예시 스케치를 다운로드 합니다. -10. `$ npm start` -11. 브라우저에서 [http://localhost:8000](http://localhost:8000)에 접속하십시오. -12. [리액트 개발자 도구](https://chrome.google.com/webstore/detail/react-developer-tools/fmkadmapgofadopljbjfkapdkoienihi?hl=en)를 설치하십시오. -13. `ctrl+h`로 리덕스 개발자 툴 열기와 닫기를, 그리고 `ctrl+w`로 이동시키기를 하십시오. - -## 도커 설치 - -_주의_: 다음의 설치 단계들은 유닉스 계열의 쉘을 이용한다는 가정이 깔려 있습니다. 만약 윈도우를 사용하고 계신다면 `cp` 대신 `copy`를 사용해야 할 것입니다. - -도커를 이용하면 Node, Mongo 등의 디펜던시들을 수동으로 설치할 필요 없이 완전하고 일관성 있는 개발 환경을 얻을 수 있게 됩니다. 또한 이는 같은 컴퓨터에서 다른 버전을 사용하는 다른 프로젝트로부터 디펜던시와 데이터를 분리시키는데에도 유용합니다. - -다만 이는 여러분의 컴퓨터의 상당한 용량을 차지한다는 점을 주의하십시오. 최소한 5GB의 여유 공간을 확보해두시기 바랍니다. - -1. 운영 체제에 도커를 설치하십시오. - * 맥: https://www.docker.com/docker-mac - * 윈도우: https://www.docker.com/docker-windows -2. 저장소를 클론하고 cd를 이용해 해당 저장소로 들어가십시오. -3. `$ docker-compose -f docker-compose-development.yml build` -4. `$ cp .env.example .env` -5. (선택사항) 깃허브에 로그인 하고 싶을 경우 깃헙 ID를 더하는 등 특정한 행동을 가능하게 하고 싶을 경우 .env에 필수 키를 업데이트 하십시오. -6. `$ docker-compose -f docker-compose-development.yml run --rm app npm run fetch-examples` - -이제, 언제든지 디펜던시와 함께 서버를 시작시키기를 원할 때면 다음을 실행하시면 됩니다: - -7. `$ docker-compose -f docker-compose-development.yml up` -8. 브라우저에서 [http://localhost:8000](http://localhost:8000)에 접속하십시오. - -실행되고 있는 도커 서버에서 터미널/쉘 열기(즉, `docker-compose up`이 실행된 이후): - -9. `$ docker-compose -f docker-compose-development.yml exec app bash -l` - -완전한 서버 환경이 실행되고 있지 않은 경우, 일회용 컨테이너 인스턴스를 런칭하고 전부 사용한 후에는 자동으로 삭제되도록 할 수 있습니다: - -10. `$ docker-compose -f docker-compose-development.yml run app --rm bash -l` - -## S3 버킷 환경 설정 - -애플리케이션 중 유저가 이미지, 비디오 등을 업로드 할 수 있도록 해주는 부분을 작업하지 않는 이상 이 부분은 필수 사항은 아니라는 점을 참고하십시오. 본 프로젝트에 사용될 S3 버킷을 설치하는 과정의 [요약본](https://gist.github.com/catarak/70c9301f0fd1ac2d6b58de03f61997e3)을 참고하십시오. - -만약 여러분의 S3 버킷이 미국 동부(북 버지니아) 지역(us-east-1)에 있다면, 해당 지역은 다른 지역과 달리 표준 명명 패턴을 따르지 않기 때문에 커스텀 URL 베이스를 설정해야 합니다. 다음을 environment/.env 파일에 추가해주십시오: - -`S3_BUCKET_URL_BASE=https://s3.amazonaws.com` - -커스텀 도메인 이름을 사용하기 위한 S3 버킷과 DNS 기록 환경을 설정했다면, 다음 변수를 이용해 커스텀 URL 베이스를 설정할 수도 있습니다: - -`S3_BUCKET_URL_BASE=https://files.mydomain.com` - -커스텀 도메인을 사용하는데에 필요한 더 많은 정보를 보기 위해선 다음의 문서 링크를 확인하십시오: -http://docs.aws.amazon.com/AmazonS3/latest/dev/VirtualHosting.html#VirtualHostingCustomURLs From b0494bf34ea3becc303f1f35d9b1ccc9830a44df Mon Sep 17 00:00:00 2001 From: Minjun Kim Date: Thu, 9 Apr 2020 14:38:28 +0200 Subject: [PATCH 5/6] delete ko directory in the root --- ko/README.md | 38 -------------------------------------- 1 file changed, 38 deletions(-) delete mode 100644 ko/README.md diff --git a/ko/README.md b/ko/README.md deleted file mode 100644 index 9be60b7a4e..0000000000 --- a/ko/README.md +++ /dev/null @@ -1,38 +0,0 @@ -# [p5.js 웹 에디터](https://editor.p5js.org) - -p5.js 웹 에디터는 예술가, 디자이너, 교육자, 초급자, 그 외에도 코딩을 배우고 싶어하는 모든 이들을 포함해 최대한 많은 사람들에게 코딩을 접근 가능하도록 만드는데에 초점을 맞춘 창의적 코딩을 위한 플랫폼입니다. 웹사이트만 열면 다운로드나 설정을 할 필요도 없이 곧바로 p5.js 스케치를 작성할 수 있습니다. 본 에디터는 제한적인 기능만을 제공하고 불필요한 장식을 없애는 등 단순함을 염두에 두고 만들어졌습니다. 우리는 이 에디터를 개발해나감에 있어서 커뮤니티의 의견에 귀 기울이고, 모든 변경 사항에 의도를 깃들일 수 있도록 노력하고 있습니다. 본 에디터는 무료이며 오픈 소스입니다. - -우리는 또한 커뮤니티에게 최대한 많은 주인 의식과 통제권을 드리고자 노력합니다. 여러분이 작성한 스케치를 다운로드해 로컬 환경에서 스케치를 편집하는 것도 가능하며, 다른 곳에 호스팅 하는 것 역시 가능합니다. 여러분은 자신만의 에디터 버전을 호스팅해 데이터에 대한 통제권을 지닐 수도 있습니다. - -## 커뮤니티 - -p5.js 커뮤니티에 처음 오셨나요? 그렇다면 먼저 저희의 [커뮤니티 성명서](https://p5js.org/community/)를 읽어주시기 바랍니다. - -## 행동 수칙 - -p5.js 웹 에디터의 모든 컨트리뷰터들은 다음의 [행동 수칙](./.github/CODE_OF_CONDUCT.md)을 따라야 합니다. 우리는 친근감 있고 안전한 커뮤니티를 만들고자 노력하고 있습니다! - -## 참여하기 - -p5.js 웹 에디터는 다수의 개인들에 의해 만들어진 협력 프로젝트이며, 여러분 역시 도움을 주실 수 있습니다. 모든 종류의 참여를 환영합니다! 더 자세한 사항을 위해서는 [기여 안내](./.github/CONTRIBUTING.md)를 확인하시기 바랍니다. - -개발자 분들은 코드 기여, 버그 수정, 문서화에 대한 세부 사항을 [개발자 문서](https://github.com/processing/p5.js-web-editor/blob/master/developer_docs/)에서 확인하시기 바랍니다. 코드 작성을 시작하기 위한 좋은 시작점은 [개발 안내](https://github.com/processing/p5.js-web-editor/blob/master/developer_docs/development.md)를 살펴보는 것입니다. - -## 이슈 - -p5.js 웹 에디터에서 버그를 발견하셨다면, [“이슈” 탭](https://github.com/processing/p5.js-web-editor/issues)에 해당 문제를 보고하실 수 있습니다. - -버그와 기능 요청은 각각에 알맞은 저장소에 보고해주시기 바랍니다: - -* p5.js 라이브러리와 p5.dom: [https://github.com/processing/p5.js/issues](https://github.com/processing/p5.js/issues) -* p5.accessibility: [https://github.com/processing/p5.accessibility/issues](https://github.com/processing/p5.accessibility/issues) -* p5.sound: [https://github.com/processing/p5.js-sound/issues](https://github.com/processing/p5.js-sound/issues) -* p5.js 웹사이트: [https://github.com/processing/p5.js-website/issues](https://github.com/processing/p5.js-website/issues) - -## 감사의 말 - -본 프로젝트는 [프로세싱 재단](https://processingfoundation.org/), [뉴욕대 ITP](https://tisch.nyu.edu/itp), [뉴욕시 교육부의 CS4All](http://cs4all.nyc/)에서 후원해주셨습니다. - -호스팅과 기술적 지원은 다음 단체들에서 해주셨습니다:
- - From 4844199ef076a5c9c29c47177b8c8819899be8ab Mon Sep 17 00:00:00 2001 From: mjaything <13192500+mjaything@users.noreply.github.com> Date: Wed, 15 Apr 2020 13:26:40 +0200 Subject: [PATCH 6/6] Restore Korean translation of installation.md --- translations/ko/installation.md | 77 +++++++++++++++++++++++++++++++++ 1 file changed, 77 insertions(+) diff --git a/translations/ko/installation.md b/translations/ko/installation.md index 8b13789179..15abf29fc9 100644 --- a/translations/ko/installation.md +++ b/translations/ko/installation.md @@ -1 +1,78 @@ +# 설치 +다음의 안내를 따라 본 프로젝트에 코드를 기여하기 위해 필요한 개발 환경을 설정해주십시오. + +## 수동 설치 + +_주의_: 다음의 설치 단계들은 유닉스 계열의 쉘을 이용한다는 가정이 깔려 있습니다. 만약 윈도우를 사용하고 계신다면 `cp` 대신 `copy`를 사용해야 할 것입니다. + +1. Node.js를 설치하십시오. [nvm](https://github.com/nvm-sh/nvm)을 통해 설치하는 걸 권장드립니다. 혹은 Node.js 웹사이트를 통해 [node.js](https://nodejs.org/download/release/v12.16.1/) 버전 12.16.1을 설치하는 것도 가능합니다. +2. [p5.js 웹 에디터 저장소](https://github.com/processing/p5.js-web-editor)를 여러분의 깃허브 계정에 [포크](https://help.github.com/articles/fork-a-repo)하십시오. +3. 포크한 깃허브 저장소를 여러분의 로컬 컴퓨터에 [클론](https://help.github.com/articles/cloning-a-repository/)하십시오. + + ``` + $ git clone https://github.com/YOUR_USERNAME/p5.js-web-editor.git + ``` + +4. nvm을 사용하신다면, $ nvm use 를 실행해 Node 버전을 12.16.1로 설정하십시오. +5. 프로젝트 폴더로 가서 npm을 이용해 필요한 모든 디펜던시들을 설치하십시오. + + ``` + $ cd p5.js-web-editor + $ npm install + ``` +6. MongoDB를 설치하고 잘 실행되는지 확인하십시오 + * [homebrew](http://brew.sh/)가 있는 맥 OSX:`brew tap mongodb/brew` 이후 `brew install mongodb-community` 그리고 `brew services start mongodb-community`로 서버를 시작하거나 다음의 설치 가이드를 살펴보십시오. [맥OS를 위한 설치 가이드](https://docs.mongodb.com/manual/tutorial/install-mongodb-on-os-x/) + * 윈도우와 리눅스: [MongoDB 설치](https://docs.mongodb.com/manual/installation/) +7. `$ cp .env.example .env` +8. (선택사항) 깃허브에 로그인 하고 싶을 경우 깃헙 ID를 더하는 등 특정한 행동을 가능하게 하고 싶을 경우 .env에 필수 키를 업데이트 하십시오. +9. `$ npm run fetch-examples` - 이는 p5라 불리는 유저로 예시 스케치를 다운로드 합니다. +10. `$ npm start` +11. 브라우저에서 [http://localhost:8000](http://localhost:8000)에 접속하십시오. +12. [리액트 개발자 도구](https://chrome.google.com/webstore/detail/react-developer-tools/fmkadmapgofadopljbjfkapdkoienihi?hl=en)를 설치하십시오. +13. `ctrl+h`로 리덕스 개발자 툴 열기와 닫기를, 그리고 `ctrl+w`로 이동시키기를 하십시오. + +## 도커 설치 + +_주의_: 다음의 설치 단계들은 유닉스 계열의 쉘을 이용한다는 가정이 깔려 있습니다. 만약 윈도우를 사용하고 계신다면 `cp` 대신 `copy`를 사용해야 할 것입니다. + +도커를 이용하면 Node, Mongo 등의 디펜던시들을 수동으로 설치할 필요 없이 완전하고 일관성 있는 개발 환경을 얻을 수 있게 됩니다. 또한 이는 같은 컴퓨터에서 다른 버전을 사용하는 다른 프로젝트로부터 디펜던시와 데이터를 분리시키는데에도 유용합니다. + +다만 이는 여러분의 컴퓨터의 상당한 용량을 차지한다는 점을 주의하십시오. 최소한 5GB의 여유 공간을 확보해두시기 바랍니다. + +1. 운영 체제에 도커를 설치하십시오. + * 맥: https://www.docker.com/docker-mac + * 윈도우: https://www.docker.com/docker-windows +2. 저장소를 클론하고 cd를 이용해 해당 저장소로 들어가십시오. +3. `$ docker-compose -f docker-compose-development.yml build` +4. `$ cp .env.example .env` +5. (선택사항) 깃허브에 로그인 하고 싶을 경우 깃헙 ID를 더하는 등 특정한 행동을 가능하게 하고 싶을 경우 .env에 필수 키를 업데이트 하십시오. +6. `$ docker-compose -f docker-compose-development.yml run --rm app npm run fetch-examples` + +이제, 언제든지 디펜던시와 함께 서버를 시작시키기를 원할 때면 다음을 실행하시면 됩니다: + +7. `$ docker-compose -f docker-compose-development.yml up` +8. 브라우저에서 [http://localhost:8000](http://localhost:8000)에 접속하십시오. + +실행되고 있는 도커 서버에서 터미널/쉘 열기(즉, `docker-compose up`이 실행된 이후): + +9. `$ docker-compose -f docker-compose-development.yml exec app bash -l` + +완전한 서버 환경이 실행되고 있지 않은 경우, 일회용 컨테이너 인스턴스를 런칭하고 전부 사용한 후에는 자동으로 삭제되도록 할 수 있습니다: + +10. `$ docker-compose -f docker-compose-development.yml run app --rm bash -l` + +## S3 버킷 환경 설정 + +애플리케이션 중 유저가 이미지, 비디오 등을 업로드 할 수 있도록 해주는 부분을 작업하지 않는 이상 이 부분은 필수 사항은 아니라는 점을 참고하십시오. 본 프로젝트에 사용될 S3 버킷을 설치하는 과정의 [요약본](https://gist.github.com/catarak/70c9301f0fd1ac2d6b58de03f61997e3)을 참고하십시오. + +만약 여러분의 S3 버킷이 미국 동부(북 버지니아) 지역(us-east-1)에 있다면, 해당 지역은 다른 지역과 달리 표준 명명 패턴을 따르지 않기 때문에 커스텀 URL 베이스를 설정해야 합니다. 다음을 environment/.env 파일에 추가해주십시오: + +`S3_BUCKET_URL_BASE=https://s3.amazonaws.com` + +커스텀 도메인 이름을 사용하기 위한 S3 버킷과 DNS 기록 환경을 설정했다면, 다음 변수를 이용해 커스텀 URL 베이스를 설정할 수도 있습니다: + +`S3_BUCKET_URL_BASE=https://files.mydomain.com` + +커스텀 도메인을 사용하는데에 필요한 더 많은 정보를 보기 위해선 다음의 문서 링크를 확인하십시오: +http://docs.aws.amazon.com/AmazonS3/latest/dev/VirtualHosting.html#VirtualHostingCustomURLs