Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[ko] fix: update learn/Accessibility sourceCommit 2 #24292

Closed
Closed
Show file tree
Hide file tree
Changes from 2 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 0 additions & 3 deletions files/ko/_redirects.txt
Original file line number Diff line number Diff line change
Expand Up @@ -280,15 +280,12 @@
/ko/docs/Learn/CSS/Introduction_to_CSS/선택자 /en-US/docs/Learn/CSS/Building_blocks/Selectors
/ko/docs/Learn/CSS/Styling_boxes /en-US/docs/Learn/CSS/Building_blocks
/ko/docs/Learn/CSS/Styling_boxes/Backgrounds /en-US/docs/Learn/CSS/Building_blocks/Backgrounds_and_borders
/ko/docs/Learn/Common_questions/HTML_features_for_accessibility /ko/docs/Learn/Common_questions/Design_and_accessibility/HTML_features_for_accessibility
/ko/docs/Learn/Common_questions/How_does_the_Internet_work /ko/docs/Learn/Common_questions/Web_mechanics/How_does_the_Internet_work
/ko/docs/Learn/Common_questions/Pages_sites_servers_and_search_engines /ko/docs/Learn/Common_questions/Web_mechanics/Pages_sites_servers_and_search_engines
/ko/docs/Learn/Common_questions/Thinking_before_coding /ko/docs/Learn/Common_questions/Design_and_accessibility/Thinking_before_coding
/ko/docs/Learn/Common_questions/Upload_files_to_a_web_server /ko/docs/Learn/Common_questions/Tools_and_setup/Upload_files_to_a_web_server
/ko/docs/Learn/Common_questions/What_are_hyperlinks /ko/docs/Learn/Common_questions/Web_mechanics/What_are_hyperlinks
/ko/docs/Learn/Common_questions/What_is_a_URL /ko/docs/Learn/Common_questions/Web_mechanics/What_is_a_URL
/ko/docs/Learn/Common_questions/What_is_a_web_server /ko/docs/Learn/Common_questions/Web_mechanics/What_is_a_web_server
/ko/docs/Learn/Common_questions/What_software_do_I_need /ko/docs/Learn/Common_questions/Tools_and_setup/What_software_do_I_need
/ko/docs/Learn/Common_questions/set_up_a_local_testing_server /ko/docs/Learn/Common_questions/Tools_and_setup/set_up_a_local_testing_server
/ko/docs/Learn/Common_questions/코딩하기_전에_생각하기 /ko/docs/Learn/Common_questions/Design_and_accessibility/Thinking_before_coding
/ko/docs/Learn/Front-end_web_developer /ko/docs/orphaned/Learn/Front-end_web_developer
Expand Down

This file was deleted.

Original file line number Diff line number Diff line change
@@ -1,6 +1,8 @@
---
title: 나의 웹사이트를 설계하기 위해서는?
slug: Learn/Common_questions/Design_and_accessibility/Thinking_before_coding
l10n:
sourceCommit: 9de3d03957f1d66f02f45400a6981372aa368c1f
---

{{QuicklinksWithSubPages("Learn/Common_questions")}}
Expand Down Expand Up @@ -44,7 +46,7 @@ _아직 가능한 능동 학습이 없다. [기여를 고민해보라](/ko/docs/

친구와 함께하는 한 시간의 토론은 좋은 시작이지만 부족하다. 생각을 현실로 만들 길의 탁 트인 전망을 얻으려면 앉아서 생각을 구조화해야한다. 이것을 하기 위해서, 오직 펜과 종이 그리고 적어도 다음 질문에 대한 답할 시간이 필요하다.

> **참고:** **메모:** 프로젝트 관념화를 수행하기 위한 셀 수 없는 방법들이 있다. 우리는 여기에 그것들을 모두 제시할 수는 없다. (책 전체로는 충분하지 않을 것이다). 이 곳에 주는 것은 전문가들이 [Project Ideation(관념화)](<http://en.wikipedia.org/wiki/Ideation_(idea_generation)>), [Project Planning(계획)](http://en.wikipedia.org/wiki/Project_planning) 그리고 [Project Management(관리)](http://en.wikipedia.org/wiki/Project_management) 라고 부르는 것을 다루는 단순한 방법이다.
> **참고:** 프로젝트 관념화를 수행하기 위한 셀 수 없는 방법들이 있다. 우리는 여기에 그것들을 모두 제시할 수는 없다. (책 전체로는 충분하지 않을 것이다). 이 곳에 주는 것은 전문가들이 [Project Ideation(관념화)](<http://en.wikipedia.org/wiki/Ideation_(idea_generation)>), [Project Planning(계획)](http://en.wikipedia.org/wiki/Project_planning) 그리고 [Project Management(관리)](http://en.wikipedia.org/wiki/Project_management) 라고 부르는 것을 다루는 단순한 방법이다.

### 내가 정확히 달성하고 싶은 것은 무엇인가?

Expand Down Expand Up @@ -88,9 +90,9 @@ _아직 가능한 능동 학습이 없다. [기여를 고민해보라](/ko/docs/

### 내 목표를 달성하기 위해, 무엇을, 어떤 순서로 해야할까?

이제 우리가 달성하고 싶은 것을 알고 있으므로, 그 목표들을 실행가능한 단계로 바꿀 시간입니다.
이제 무엇을 성취하고 싶은지 알았으니, 그 목표를 실행 가능한 단계로 바꿀 시간입니다. 참고로, 목표는 반드시 고정된 것이 아닙니다. 프로젝트가 진행되는 동안 예상치 못한 장애물을 만나거나 마음이 바뀌는 경우에 따라 시간이 지나면서 변화할 수 있습니다.

긴 설명을 하기 보다는 이 표로 우리의 예제를 돌아봅시다.
긴 설명을 하기보다는, 이 표와 함께 예제로 돌아가 보겠습니다.

<table class="standard-table">
<thead>
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,8 @@
---
title: 로컬 테스트 서버 설치하기
slug: Learn/Common_questions/Tools_and_setup/set_up_a_local_testing_server
l10n:
sourceCommit: 33cada2d06f8d0cd009d9d5348de6e3165bba67f
---

{{QuicklinksWithSubPages("Learn/Common_questions")}}
Expand Down Expand Up @@ -36,62 +38,101 @@ slug: Learn/Common_questions/Tools_and_setup/set_up_a_local_testing_server

- **비동기 요청인 경우**. 일부 브라우저(크롬을 포함하는)에서는 로컬 파일의 예제를 실행할 경우에 비동기 요청([서버로부터 데이터 가져오기 - Fetching data from the server](/ko/docs/Learn/JavaScript/Client-side_web_APIs/Fetching_data)를 참고)이 작동하지 않을 것입니다. 이는 보안 제한(웹 보안과 관련된 자세한 내용은 [웹사이트 보안- Website security](/ko/docs/Learn/Server-side/First_steps/Website_security)을 참고하세요) 때문입니다.
- **서버측 언어인 경우**. 서버측 언어(PHP나 Python과 같은)는 코드를 해석하고 결과를 내보낼 수 있는 특별한 서버가 필요합니다.
- **다른 파일을 포함하는 경우**. 브라우저는 일반적으로 `file://` 스키마를 사용하여 리소스를 로드하는 요청을 교차 출처 요청으로 처리합니다.
따라서 다른 로컬 파일을 포함하는 로컬 파일을 불러올 경우, 이는 {{Glossary("CORS")}} 오류를 유발할 수 있습니다.

## 간단한 로컬 HTTP 서버 실행하기

비동기 요청 문제를 해결하려면 로컬 웹 서버에서 예제를 실행하여 테스트해야 합니다. 이를 위한 가장 쉬운 방법은 파이썬(Python)의 `SimpleHTTPServer` 모듈을 사용하는 것입니다. (설치된 파이썬 버전에 따라 `http.server` 모듈을 사용해야 할 수도 있습니다.)
비동기 요청 문제를 해결하려면 로컬 웹 서버를 통해 이러한 예제를 테스트해야 합니다.

이를 위해.
### 코드 편집기에서 확장 기능 사용하기

1. 파이썬을 설치합니다. 리눅스나 맥OS 사용자라면 이미 시스템에 설치되어 있을 것입니다. 윈도우 사용자일 경우, 다음과 같이 파이썬 홈페이지로부터 설치 프로그램을 다운 받고 설치합니다.
HTML, CSS, JavaScript만 필요하고 서버 측 언어가 필요하지 않다면, 코드 편집기에서 확장 기능을 확인하는 것이 가장 쉬운 방법일 수 있습니다. 로컬 HTTP 서버의 설치와 설정을 자동화할 뿐만 아니라, 코드 편집기와 잘 통합되어 로컬 파일을 HTTP 서버에서 한 번의 클릭으로 테스트할 수 있습니다.

- 파이썬 홈페이지([python.org](https://www.python.org/))로 이동합니다.
- 다운로드(download) 영역에서 Python "3.xxx" 링크를 클릭합니다.
- 페이지의 아래쪽에 있는 *Windows x86 executable installer*를 선택하고 다운로드 받습니다.
- 다운로드가 완료되면 실행합니다.
- 설치 프로그램의 첫 번째 페이지에서 "Add Python 3.xxx to PATH" 체크박스를 체크해야 합니다.
- *Install*을 클릭하고 설치가 완료되면 *Close*를 클릭합니다.
VSCode의 경우 다음 무료 확장을 확인할 수 있습니다.

2. 명령 실행창(윈도우의 경우는 command prompt, OS/X나 리눅스인 경우에는 터미널창)을 엽니다. 파이썬이 설치되었는지 확인하기 위해 다음 명령을 입력합니다.
- `vscode-preview-server`. [홈페이지](https://marketplace.visualstudio.com/items?itemName=yuichinukiyama.vscode-preview-server)에서 확인할 수 있습니다.

```bash
python -V
```
### Node.js 사용하기

3. 이 명령은 버전 번호를 반환합니다. 정상적으로 작동하면, `cd` 명령을 이용해 여러분의 예제가 존재하는 디렉토리로 이동합니다.
Node.js의 [`http-server`](https://www.npmjs.com/package/http-server) 모듈은 어떤 폴더에서든 HTML 파일을 호스팅할 수 있는 가장 쉬운 방법입니다.

```bash
# 들어가고자 하는 디렉토리 명을 입력합니다. 예를 들어,
cd Desktop
# 한 단계 상위 디렉토리로 이동하려면 점 두 개를 사용합니다.
cd ..
```
이 모듈을 사용하려면,

4. 그 경로에 있는 서버를 구동하기 위한 명령을 입력합니다.
1. 다음 명령어를 실행하여 Node.js가 이미 설치되어 있는지 확인합니다.

```bash
# 위에서 반환된 파이썬 버전이 3.X인 경우
python -m http.server
# 위에서 반환된 파이썬 버전이 2.X인 경우
python -m SimpleHTTPServer
```
```bash
node -v
npm -v
npx -v
```
hochan222 marked this conversation as resolved.
Show resolved Hide resolved

5. 이 명령은 기본적으로 로컬 웹 서버의 8000번 포트를 이용해 해당 경로의 컨텐츠를 실행시킵니다. 웹 브라우저에서 주소줄에 `localhost:8000`를 입력하면 이 서버로 이동할 수 있습니다. 그러면 그 디렉토리의 컨텐츠 목록을 볼 수 있는데 실행하고자 하는 HTML 파일을 클릭합니다.
2. Node.js가 설치되지 않았다면, [설치 가이드](https://nodejs.org/en/download/package-manager)를 참고하여 설치 후 위 명령어를 다시 실행하여 설치가 성공했는지 확인합니다.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[markdownlint] reported by reviewdog 🐶
MD029/ol-prefix Ordered list item prefix [Expected: 1; Actual: 2; Style: 1/2/3]


> [!NOTE]
> 8000번 포트에 이미 실행 중인 무언가가 있다면 서버 실행 명령에 다음과 같이 대체 포트 번호를 명시함으로써 다른 포트로 서버를 구동할 수 있습니다.
>
> 예: `python -m http.server 7800` (Python 3.x일 경우) 또는 `python -m SimpleHTTPServer 7800` (Python 2.x일 경우). 이 경우, `localhost:7800`를 통해 서버로 이동할 수 있습니다.
3. 폴더가 `/path/to/project`라고 가정하고, 서버를 시작하려면 다음 명령어를 실행합니다.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[markdownlint] reported by reviewdog 🐶
MD029/ol-prefix Ordered list item prefix [Expected: 2; Actual: 3; Style: 1/2/3]


## 서버측 언어를 로컬에서 실행하기
```bash
npx http-server /path/to/project -o -p 9999
```
hochan222 marked this conversation as resolved.
Show resolved Hide resolved

파이썬의 `SimpleHTTPServer (python 2.0) http.server (python 3.0)` 모듈은 유용하기는 하나 파이썬이나 PHP 또는 JavaScript와 같은 언어로 작성된 코드를 실행하지 못합니다. 이런 코드를 처리하기 위해서는 뭔가가 더 필요합니다 — 정확하게 무엇이 필요한지는 실행하고자 하는 서버측 언어가 무엇인지에 따라 다릅니다. 다음에 몇 가지 사례를 소개합니다.
이 명령어는 `/path/to/project` 폴더 내 모든 파일을 `localhost:9999`에서 호스팅합니다. `-o` 옵션은 `index.html` 페이지를 웹 브라우저에서 자동으로 열어줍니다. `index.html` 파일이 없을 경우, 폴더 목록이 표시됩니다.
hochan222 marked this conversation as resolved.
Show resolved Hide resolved

- 파이썬으로된 서버측 코드를 실행하기 위해서는 파이썬 웹 프레임워크(Python web framework)를 사용할 필요가 있습니다. [Django Web Framework (Python)](/ko/docs/Learn/Server-side/Django)를 읽어보면 Django framework를 이용하는 법을 알 수 있습니다. [Flask](http://flask.pocoo.org/)는 Djang를 대신할 좋은(조금 더 가벼운) 대안이될 수 있습니다. Flask를 실행하기 위해서는 Python/PIP([install Python/PIP](/ko/docs/Learn/Server-side/Django/development_environment#Installing_Python_3))를 설치하고, `pip3 install flask` 명령으로 Flask를 설치해야 합니다. 이 때부터 파이썬 Flask 예제를 실행할 수 있는데, 예를 들어, `python3 python-example.py`명령을 실행하고 브라우저에서 `localhost:5000`으로 이동하면 됩니다.
- Node.js (JavaScript)라는 서버측 코드를 실행하기 위해서는 기본 node(raw node)나 그 위에 설치되는 프레임워크를 이용해야 합니다. Express가 좋은 선택이될 수 있습니다 — [Express Web Framework (Node.js/JavaScript)](/ko/docs/Learn/Server-side/Express_Nodejs)를 살펴보시기 바랍니다.
- PHP로된 서버측 코드를 실행하려면 PHP에 내장된 개발서버([PHP's built-in development server](http://php.net/manual/en/features.commandline.webserver.php))를 실행시킵니다.
### Python 사용하기

```bash
cd path/to/your/php/code
php -S localhost:8000
```
또 다른 방법으로 Python의 `http.server` 모듈을 사용할 수 있습니다.

> [!NOTE]
hochan222 marked this conversation as resolved.
Show resolved Hide resolved
> Python의 오래된 버전(2.7까지)에는 `SimpleHTTPServer`라는 유사한 모듈이 제공되었습니다. Python 2는 이미 지원이 종료되었으므로 Python 3 사용을 권장합니다.

이 방법을 사용하려면,

1. Python이 설치되어 있는지 확인하려면 다음 명령어를 실행합니다.

```bash
python -V
# 위 명령어가 실패하면,
python3 -V
# 또는 "py" 명령어가 사용 가능하면,
py -3 -V
```
hochan222 marked this conversation as resolved.
Show resolved Hide resolved

2. Python이 설치되어 있지 않으면, [설치 가이드](https://www.python.org/downloads/)를 참고하여 설치하세요. (더 자세한 설명은 [Django 튜토리얼](/ko/docs/Learn/Server-side/Django/development_environment#installing_python_3)에서도 확인할 수 있습니다). 설치가 완료되면 위 명령어를 다시 실행하여 설치가 성공했는지 확인합니다.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[markdownlint] reported by reviewdog 🐶
MD029/ol-prefix Ordered list item prefix [Expected: 1; Actual: 2; Style: 1/2/3]


3. Python이 설정되었다면, `cd` 명령어를 사용하여 테스트할 웹사이트 코드가 있는 폴더로 이동합니다.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[markdownlint] reported by reviewdog 🐶
MD029/ol-prefix Ordered list item prefix [Expected: 2; Actual: 3; Style: 1/2/3]


``` bash
# 폴더 이름을 입력하여 이동합니다, 예를 들어
cd Desktop
# 상위 폴더로 이동하려면 두 점을 사용합니다
cd ..
```
hochan222 marked this conversation as resolved.
Show resolved Hide resolved

4. 해당 폴더에서 서버를 시작하는 명령어를 입력합니다.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[markdownlint] reported by reviewdog 🐶
MD029/ol-prefix Ordered list item prefix [Expected: 1; Actual: 4; Style: 1/2/3]


```bash
# Windows에서는 "python -m http.server" 또는 "py -3 -m http.server" 사용
python3 -m http.server
```
hochan222 marked this conversation as resolved.
Show resolved Hide resolved

5. 기본적으로, 이 명령어는 해당 폴더의 내용을 로컬 웹 서버의 포트 8000에서 실행합니다. 웹 브라우저에서 `localhost:8000` URL로 이동하여 이 서버에 접속할 수 있습니다. 여기서 폴더의 내용이 나열되며, 실행하려는 HTML 파일을 클릭하면 됩니다.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[markdownlint] reported by reviewdog 🐶
MD029/ol-prefix Ordered list item prefix [Expected: 1; Actual: 5; Style: 1/2/3]


> [!NOTE]
hochan222 marked this conversation as resolved.
Show resolved Hide resolved
> 포트 8000에서 이미 실행 중인 항목이 있는 경우, 서버 명령어 뒤에 다른 포트 번호를 지정하여 실행할 수 있습니다. 예: `python3 -m http.server 7800`. 이 경우 `localhost:7800`에서 콘텐츠에 접근할 수 있습니다.

## 서버 측 언어를 로컬에서 실행하기

Python, PHP, JavaScript 같은 서버 측 언어를 사용하는 경우, 서버 측 언어와 웹 프레임워크 또는 "단독" 코드에 따라 다른 접근 방식이 필요합니다.

웹 프레임워크를 사용하는 경우, 일반적으로 프레임워크 자체에서 개발 서버를 제공합니다. 예를 들어, 다음 언어/프레임워크는 개발 서버를 함께 제공합니다.

- Python 웹 프레임워크, 예: [Django](/ko/docs/Learn/Server-side/Django), [Flask](https://flask.palletsprojects.com/), 그리고 [Pyramid](https://trypyramid.com/)
- Node/JavaScript 프레임워크, 예: [Express Web Framework (Node.js/JavaScript)](/ko/docs/Learn/Server-side/Express_Nodejs)
- PHP는 [자체 내장 개발 서버](https://www.php.net/manual/en/features.commandline.webserver.php)를 가지고 있습니다.

```bash
cd path/to/your/php/code
php -S localhost:8000
```

서버 측 프레임워크나 개발 서버를 제공하는 프로그래밍 언어를 사용하지 않는 경우, Python의 `http.server` 모듈을 사용하여 CGI(Common Gateway Interface) 스크립트를 호출함으로써 Python, PHP, JavaScript 등으로 작성된 서버 측 코드를 테스트할 수 있습니다.
이 기능 사용 예시는 [Execute a Script Remotely Through the Common Gateway Interface (CGI)](https://realpython.com/python-http-server/#execute-a-script-remotely-through-the-common-gateway-interface-cgi)의 _How to Launch an HTTP Server in One Line of Python Code_에서 확인할 수 있습니다.
hochan222 marked this conversation as resolved.
Show resolved Hide resolved
Loading