이 저장소는 vulkan-tutorial.com의 내용을 호스팅합니다. 웹 사이트 자체는 github 맛의 마크 다운을 지원하는 daux.io를 기반으로합니다. 실제 사이트는 사용자 정의 테마와 몇 가지 수정 (https://github.com/overv/daux.io)으로 daux.io를 실행하며 Docker 이미지에 내장되어 있습니다.
웹 사이트와 관련된 피드백을 제공하기 위해 문제를 사용하고 요청을 당깁니다. 코드에 문제가있는 경우 관련 장의 주석 섹션을 사용하여 질문을하십시오. 운영 체제, 그래픽 카드, 드라이버 버전, 소스 코드, 예상 동작 및 실제 동작을 제공하십시오.
이 안내서는 이제 전자 책 형식으로도 제공됩니다.
전자 책은 기존 컨텐츠에서 실행하여 구축 할 수 있습니다.
python3 build_ebook.py
이 스크립트는 경로에서 사용할 수있는 다음 유틸리티에 따라 다릅니다.
inkscape : SVG에서 PNG 변환 (버전 1.0.2로 테스트)pandoc : Markdown 코드에서 PDF 및 Epub 구축 (버전 2.13으로 테스트)또한 PDF 생성을 위해 라텍스 배포를 설치해야합니다.
때로는 createBuffer 와 같은 함수와 같은 많은 장에서 재사용되는 코드를 변경해야합니다. 그러한 변경을 수행하면 다음 단계를 사용하여 코드 파일을 업데이트해야합니다.
base_code_fixed.cpp .diff -Naur base_code.cpp base_code_fixed.cpp > patch.txt 사용하여 패치를 만듭니다.incremental_patch.sh 스크립트를 사용하여 지정된 코드 파일과 이후 챕터의 모든 파일에 패치를 적용하십시오. : ./incremental_patch.sh base_code.cpp patch.txt .base_code_fixed.cpp 및 patch.txt 파일을 정리하십시오.튜토리얼을 렌더링하려면 (즉, Markdown을 HTML로 변환) 두 가지 옵션이 있습니다.
이러한 옵션 중 하나에는 PHP와 패치가 필요합니다.
php_mbstring 및 php_openssl 확장자 모두를 활성화해야합니다.phar.readonly 설정은 Off 으로 설정해야합니다 (Daux를 재건 할 수 있으려면)git clone https://github.com/dauxio/daux.io.gitgit checkout d45ccff -b vtpatchmaster 재설정 할 수 있듯이 새 지점을 만드는 것은 엄격히 필요하지 않지만 마스터가 손상되지 않습니다.daux.patch 파일을 daux.io 디렉토리로 복사하고 줄 종료가 Unix 스타일인지 확인하고 패치를 적용하십시오. 깨끗하게 적용해야합니다.git am daux.patchcomposer installphp bin/compile (시간이 걸릴 수 있음)daux.phar 는 이제 기본 디렉토리에 있습니다.위의 것을 완료 한 후에는 웹 서버를 사용하여 Daux를 실행하는 방법에 대한 Daux 사이트의 지침을 따르십시오.
PHP를 설치 한 것을 고려할 때 간단한 옵션으로, 현지에서의 모습을 현지에서 볼 수있는 경우 PHP의 내장 개발 웹 서버를 사용할 수도 있습니다.
daux.io 디렉토리에서 vulkantutorial 디렉토리에서 docs_directory 옵션을 가리키도록 global.json 편집하십시오."docs_directory": "../VulkanTutorial",daux.io 디렉토리에서 실행하십시오php -S localhost:8080 index.phplocalhost:8080 입력하고 Enter를 누르십시오. 이제 Vulkantutorial 프론트 페이지가 표시됩니다.정적 파일을 생성하기 전에 Daux와 튜토리얼 설정을 조정하여 외부 리소스를 몇 가지 외부 리소스를로드하려고하지 않도록해야합니다 (다른 정적 페이지를로드하려고 할 때 브라우저를 실속화 함).
VulkanTutorial 디렉토리에서 config.json 편집하고 google_analytics 라인을 제거하여 Daux가로드하려고하지 않습니다.daux.io 디렉토리에서 themes/daux/config.json 편집하고 font 줄을 제거하여 daux가 외부 글꼴을로드하려고하지 않도록하십시오.우리는 개선을 위해 노력하고 있으므로 향후 위의 단계는 필요하지 않습니다.
위의 작업을 수행하면 정적 파일을 생성 할 수 있습니다. daux.io와 vulkantutorial 디렉토리가 서로 옆에 있고 daux.io 디렉토리로 이동하여 php generate -s ../VulkanTutorial -d ../VulkanTutorial/out 과 유사한 명령을 실행하십시오.
-s 문서를 찾을 위치를 알려주고 -d 는 생성 된 파일을 어디에 넣을 위치를 알려줍니다.
참고 : 문서를 다시 생성하려면 out Directory를 먼저 삭제하거나 DAUX가 out 디렉토리 내에서 새 out 를 만듭니다.
이 저장소의 내용은 달리 명시되지 않는 한 CC By-SA 4.0으로 라이센스가 부여됩니다. 이 저장소에 기여함으로써 귀하는 동일한 라이센스에 따라 귀하의 기부금을 대중에게 라이센스를 부여하는 데 동의합니다.
code 디렉토리의 코드 목록은 CC0 1.0 범용으로 라이센스가 부여됩니다. 해당 디렉토리에 기여함으로써 귀하는 동일한 공개 도메인과 같은 라이센스에 따라 대중에게 귀하의 기부금을 라이센스에 동의합니다.