PHP에 기여 : PHP의 매뉴얼에 기여하는 방법

이 두 부분으로 구성된 시리즈는 PHP 프로젝트에 기여하는 방법을 살펴보고 1 부의 문서에 중점을 둡니다. 계정 요청 및 승인 후 단계를 다룰 것입니다

키 포인트 :

PHP의 문서에 기여하면 언어를 향상시키고 PHP 전문 지식을 향상시킵니다. 또한 언어의 방향에 영향을 미치는 php.net 계정으로 이어질 수 있습니다.

문서는 DocBook XML을 사용합니다. 친숙 함은 도움이되지만 필수는 아닙니다 초보자는 온라인 편집자를 사용하여 간단한 패치를 사용할 수 있습니다. 스타일 가이드 라인을 미리 검토하는 것이 좋습니다 빈번한 기고자 또는 광범위한 편집이 필요한 사람들은 문서를 로컬로 설정하고 php.net 계정을 요청해야합니다. 여기에는 디렉토리 작성, 문서 복제 및 SVN 키워드 구성이 포함됩니다. 기부금에는 버그 수정, 번역, 기존 컨텐츠 확장, 문서화되지 않은 기능 문서 및 일반 개선이 포함됩니다.

왜 기여 하는가?

오픈 소스 인 PHP는 커뮤니티 참여에 번성합니다. 참여 증가는 모든 사람에게 이익을줍니다. 문서 개선, 버그 수정 또는 기능 추가에 관계없이 모든 기여는 계산됩니다. 적극적인 참여는 PHP 지식을 심화시키고 언어의 미래를 형성하여 Php.net 계정을 요청할 수 있습니다.

PHP의 문서 이해
• 문서는 DocBook XML에 있습니다. 사전 지식은 엄격하게 필요하지 않습니다. XML 구문은 쉽게 배우게됩니다 디렉토리 구조는 다음과 같습니다
에는 XML 문서를 변환하기위한 도구가 포함되어 있습니다. 는 영어 문서를 보유하고 있습니다 (다른 언어는 2 글자 코드를 사용합니다). 에는 확장 특이 적 디렉토리가 포함되어 있습니다 (절차 확장 기능, 객체 지향적 인 폴더의 클래스 이름 폴더). 각 확장자 폴더에는 문서는 현재 SVN 기반입니다 (GIT로 마이그레이션). 로컬 설정은 SVN 친숙 함이 필요합니다
• 첫 번째 기고자
• 온라인 문서 편집기를 사용하여 시작하십시오. 이를 통해 OAUTH 로그인 및 간단한 패치를 제출할 수 있습니다. 일관된 계정 사용 향후 php.net 계정 응용 프로그램에 대한 추적 기여도를 단순화합니다. 패치를 제출하기 전에 스타일 지침에 익숙해 지십시오 예 : 버그 해결 #71716
이 버그는 샘플에서 네임 스케이팅 된 MongoDB 클라이언트 클래스를 잘못보고합니다. 확인 후 온라인 편집기를 사용하여 네임 스페이스를 수정하십시오.
• Video Embed : https://www.php.cn/link/14aa36297925d3c82891d74fa28d7df1

  (필요한 경우 실제 포함 코드로 바꾸십시오) 로컬 셋업 온라인 편집자는 제한되어 있습니다. 보다 실질적인 기여를하려면 문서를 로컬로 설정하고 php.net 계정을 요청하십시오.

  a 디렉토리를 만듭니다 SVN을 사용하여 문서를 복제하십시오 : 복제 박사 (렌더링 도구) :

  php.net 웹 사이트를 복제하십시오 : ;

  를 제거하고 렌더링 된 문서에 대한 상징적 링크를 만듭니다.

  svn 키워드 :
• 를 구성하십시오 (선택 사항) 검증, 빌딩 및 로컬로 문서를 보는 명령이 포함 된 phpdocs 파일을 만듭니다.
DOCS 워크 플로우 (로컬)
• 설정 후 리포지토리를 업데이트하십시오 (). 관련 XML 파일을 편집하고 를 사용하여 검증하고 PhD로 빌드 한 다음 로컬 서버를 시작하십시오. SVN을 사용하여 변경 사항을 커밋하고 버그 번호를 참조하십시오. 변경 사항이 전파 된 후 "개발자"탭에서 버그 보고서를 닫습니다. php.net 계정을 요청 svn checkout https://svn.php.net/repository/phpdoc/modules/doc-en 로컬 설정 후 Docs Karma와 함께 php.net 계정을 요청하십시오. 엄격한 전제 조건은 존재하지 않지만 적극적인 기여를 보여주는 것이 중요합니다. 계정 요청 양식을 제출하고 이메일 phpdoc@lists.php.net의 의도, 위키 사용자 이름 및 과거 기부금을 설명합니다. 문서화 작업
• git clone http://git.php.net/repository/phd.git 버그 수정을 넘어 :
• 번역 부분적으로 문서화 된 자료 확장 git clone http://git.php.net/repository/web/php.git web-php 문서화되지 않은 기능 web-php/manual/en 일반 개선
• 일반 팁 ~/.subversion/config *.xml = svn:eol-style=native;svn:keywords=Id Rev Revision Date LastChangedDate LastChangedRevision Author LastChangedBy HeadURL URL
스타일 가이드 라인을 따르십시오. 버그를 고정시 관련 측면을 점검하십시오 간결하게 씁니다.
• 출력에서 ​​예제 코드를 별도로 설명합니다 올바른 페이지 순서를 확인하십시오 PHP 4 참조를 제거하십시오 버전 새 파일을 올바르게 버전 도움을 받으려면 Docs FAQ 또는 PHP-DOCS 메일 링리스트를 참조하십시오. ref 결론
이 부분은 온라인 편집기와 로컬 설정의 두 가지 워크 플로우를 다루었습니다. 2 부

faqs (더 나은 흐름을 위해 끝으로 이동)

• 기여 프로세스 : 계정 만들기, 컨텐츠 편집/작성, 번역, 지침에 따라 가이드 라인을 따르십시오. 기여의 중요성 :
문서 품질을 향상시키고, 커뮤니티를 최신 상태로 유지합니다. 수락 확인 : 지침을 따르고 정확성과 명확성을 확인하고 피드백을 받으십시오.
• > 비 원어민 영어 사용자 : 기부금을 환영합니다. 번역은 귀중한 기여입니다.
일반적인 실수 :
• 지침을 따르지 않음, 부정확 한/불분명 정보, 교정 부족, 불필요한 변경. 도움 받기 : 온라인 포럼, 토론 그룹, 문서 지침 사용. 익명의 기여 :
가능하지만 계정이 권장됩니다 기여 빈도 :
• 는 가용성과이자에 따라 다릅니다 보상 : 일반적으로 자원 봉사 활동. 보고 실수 :
기고자가있는 경우 수정하십시오. 그렇지 않으면 커뮤니티에보고하십시오.
• 자리 표시 자 이미지 URL을 실제 이미지 URL로 바꾸는 것을 잊지 마십시오. 이미지 형식을 보존하고 요청에 따라 이미지를 원래 위치로 유지했습니다.

위 내용은 PHP에 기여 : PHP의 매뉴얼에 기여하는 방법의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!