expressjs에 기여하기-JS 튜토리얼-php.cn

안녕하세요! 제 이름은 Peter입니다. 저는 컴퓨터 과학을 전공하는 학생으로 현재 David Humphrey 교수의 Open Source 2024 주제 수업을 듣고 있습니다.

2024년 9월부터 저는 오픈소스 커뮤니티에서 입지를 구축하기 위해 노력해 왔습니다. 제 여정을 따라가려면 GitHub에서 저를 찾아보세요.

peterdanwan (피터 완) · GitHub

풀스택 개발자 | 게임 및 AI 매니아 - 피터단완

프로젝트 범위 이해

첫 번째 단계: 내가 작업하는 내용을 이해합니다. expressjs.com은 Node.js의 가장 인기 있는 웹 프레임워크 중 하나인 express의 공식 문서 사이트입니다. 아름답게 디자인된 웹사이트에서 이를 빠르게 파악할 수 있었지만 여정은 이제 막 시작되었습니다.

Express - Node.js 웹 애플리케이션 프레임워크

Express는 웹 및 모바일 애플리케이션을 위한 강력한 기능 세트를 제공하는 Node.js를 위한 빠르고, 독립적이며, 미니멀한 웹 프레임워크입니다.

expressjs.com

당면한 문제 이해

프로젝트를 있는 그대로 익히고 나서 제가 해결할 수 있는 문제를 찾아봤습니다. 이걸 찾았어요:

깨진 링크 및 누락된 페이지 #1684

크리스델101 게시일: 2024년 11월 17일

다음 링크가 깨졌습니다. _includes/header/header-id.html

변경 로그 공개

_includes/header/header-th.html

บ्त्तทึггугареป้มปปมแปมแปมแปมก/a>

변경 제안: 변경 로그 릴리스

페이지 누락으로 인해 UZ 언어로 콘솔 오류 발생: /css/langs/uz.css

이 페이지를 추가해 보세요.

GitHub에서 보기

이 문제는 나에게 익숙하고 익숙한 기술인 HTML 및 CSS와 관련되어 있기 때문에 선택했습니다. 그러나 간단해 보이는 사실은 실제로 오픈 소스 개발에 대한 중요한 교훈을 가르쳐주었습니다.

익숙해 보이는 작업에도 익숙하지 않은 영역이 포함될 수 있습니다.

저장소는 제가 이전에 한 번도 접해본 적이 없는 기술을 사용했고, 그곳에서 진정한 학습이 시작되었습니다. 이 문제를 시도할지 여부를 결정하는 데 약 한 시간이 걸렸습니다. 돌이켜보면 너무 길었을 수도 있습니다. 처음 접하는 Ruby를 사용한 프로젝트라 망설여지기도 했는데요.

스포일러 주의: Ruby를 설정하는 것은... 모험이었습니다.

로컬에서 프로젝트를 설정하는 방법 이해

로컬 개발 환경 설정은 오픈 소스 기여에서 가장 교육적인 부분 중 하나인 경우가 많습니다.

expressjs.com을 로컬에서 실행해 보는 것만으로도 Ruby와 Jekyll에 대해 조금 배웠습니다.

제 여정은 다음과 같습니다.

초기 혼란: 저는 Windows에 Ruby를 직접 설치하는 것부터 시작했습니다. 작동하긴 했지만 이상적이지는 않았습니다. 왜냐하면 제가 설치한 버전이 프로젝트에 사용된 버전과 다르기 때문에 문제가 있었기 때문입니다. Windows에서의 버전 관리는 재미가 없었습니다. 그래서 Windows에 설치된 Ruby와 기타 종속 항목을 제거하고 대체 솔루션을 찾았습니다.
WSL의 발견: 제가 조사한 결과 Linux용 Windows 하위 시스템(WSL)에서 Ruby를 실행해야 한다는 결론에 도달했습니다. WSL이 훨씬 더 나은 개발 환경과 강력한 Ruby 버전 관리자(RVM)를 사용하면 다양한 버전의 Ruby를 사용하는 프로젝트에서 작업할 수 있습니다. 나에게 RVM을 설치하는 것은 매우 비슷한 느낌이었습니다. 왜냐하면 저는 nvm-windows를 사용하여 다른 노드 버전 간에 전환할 수 있기 때문입니다.
버전 관리 학습 곡선: 다시 한번 RVM과 Node.js의 nvm과의 유사성에 대해 배웠습니다. 이를 통해 개발 환경에서 버전 관리의 중요성을 배웠습니다.

다음은 개발 환경을 준비하는 데 사용한 실제 명령입니다.

## 1. Installing RVM (Ruby Version Manager)
# First, import GPG keys needed to verify RVM installation
gpg --keyserver hkp://keyserver.ubuntu.com --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3 7D2BAF1CF37B13E2069D6956105BD0E739499BDB

# Download and install RVM
\curl -sSL https://get.rvm.io | bash -s stable

# Verify RVM is installed and get its path
which rvm

# Load RVM into your current shell session
source /home/peter/.rvm/scripts/rvm

## 2. Installing Ruby
# Install Ruby version 3.3.5 (latest stable as of early 2024)
rvm install 3.3.5

# Set 3.3.5 as your default Ruby version
rvm use 3.3.5

# Verify RVM and Ruby installations
rvm -v
ruby -v

## 3. Setting up Jekyll
# Install Jekyll and Bundler gems
gem install bundler jekyll

# Install project dependencies from Gemfile (must be within the target directory with the Gemfile)
bundle install

# Start the Jekyll server with live reload and external access
# --host 0.0.0.0 allows access from other devices on your network
# --livereload automatically refreshes your browser when files change
bundle exec jekyll serve --host 0.0.0.0 --livereload

로그인 후 복사

문제 해결

개발 환경을 구성한 후 당면한 문제 해결을 시작할 수 있었습니다. 즉, 간단히 업데이트만 하면 됩니다.
영어 버전의 링크에 대한 깨진 링크를 포함하는 앵커 태그(링크의 영어 버전은 깨지지 않기 때문에).

이번 포스팅에서 가장 쉬운 부분이었습니다.

또한 수정해야 할 오류가 있는지 확인하기 위해 일부 로그를 확인하기도 했습니다. 동일한 내용을 따르는 다른 파일 css/id.css를 추가할 것을 제안했습니다
일부 오류 로그를 해결할 수 있을 것으로 예상했기 때문에 이미 추가된 파일의 코딩 형식입니다.

expressjs.com의 관리자 중 한 명인 Chris Del은 그렇게 해야 한다는 즉각적인 피드백을 제공했습니다(Chris에게 감사합니다!).

따라서 이 변경 사항을 내 Pull Request에도 추가했습니다.

변경사항 병합을 기다리고 토론에 참여하는 방법을 학습합니다.

그러므로 제가 변경한 사항은 이제 expressjs.com의 메인 브랜치에 병합되기를 기다리고 있습니다.
expressjs.com 웹사이트의 표준을 논의하기 위한 후속 이슈가 만들어졌습니다. 즉,

사용자를 올바른 언어로 된 끊어진 링크 대신 작동하는 영어 페이지로 리디렉션해야 합니까?

그것은 제가 결정할 일이 아니지만 저는 토론에 참여하고 싶었습니다. 여기에서 토론을 따라가실 수 있습니다.

오픈소스 개발자로 성장하는 법 배우기

간단한 HTML/CSS 수정으로 시작된 일이 오픈 소스 개발에 대한 귀중한 교훈을 주는 여정으로 바뀌었습니다.

편안함에서 벗어나기: 익숙한 기술(HTML/CSS)과 관련된 문제를 선택하는 동안 완전히 새로운 기술 스택(Ruby/Jekyll)을 배우게 되었습니다. 이는 익숙하지 않은 일에 기꺼이 대처할 때 성장이 이루어진다는 사실을 가르쳐 주었습니다.
기술적 성장: 개발 환경 설정, 버전 관리, 새로운 도구 사용은 모두 중요한 기술입니다. 각각의 챌린지는 다음 챌린지에 더 쉽게 접근할 수 있게 해줍니다.
커뮤니티 참여: 언어 리디렉션 토론과 같은 토론을 통해 저는 오픈 소스가 단지 코드에 관한 것이 아니라 프로젝트 결정을 형성하는 의미 있는 토론에 참여하는 것임을 배웠습니다.

앞으로 다음을 통해 개선할 계획입니다.