이것은 Julia Programming Language의 주요 웹 사이트 julialang.org의 Github 저장소입니다. 언어 자체의 소스 코드의 저장소는 github.com/julialang/julia에서 찾을 수 있습니다.
Julia 웹 사이트는 정적 웹 사이트를 구축하기위한 Julia 기본 패키지 인 Github 페이지와 Franklin.jl을 사용하여 생성됩니다.
웹 사이트 변경을 제안하려면 변경해야 할 콘텐츠를 사용하여 페이지로 이동하여 편집 할 수 있습니다. 레포를 포크 (아직하지 않은 경우)를 시작한 다음 풀 요청을 엽니 다. 풀 요청이 병합되면 몇 분 이내에 웹 사이트에 변경 사항이 표시됩니다.
각 풀 요청에 대한 빌드 미리보기는 사이트가 성공적으로 빌드되면 PR의 주석 섹션에 연결됩니다.
참고 : 울타리 코드 블록 (즉, 백 티크로 구분 된 코드 블록) 만 사용하고 강요된 코드 블록이 아닌 만 사용하십시오.
더 중요한 웹 사이트 변경을 제안하기 위해, 귀하는 상기 변경을 수행하고 장치에서 로컬로 테스트하는 것이 좋습니다. 기본 repo를 포킹하고 장치에 로컬로 클로닝하고 원하는 변경 사항을 작성한 다음 아래의 "로컬로 설치"지침을 따라함으로써이를 수행 할 수 있습니다.
모든 것이 좋아 보인다는 것을 확인한 후에는 풀 요청을 열고 NetLify에서 배포 미리보기를 최종 세력 검사로 확인할 수 있습니다.
각 풀 요청에 대한 빌드 미리보기는 다음과 같습니다.
저장소와 cd 복제하십시오. julia --project 와 함께 Julia 버전 1.10을 시작하십시오
julia > using Pkg; Pkg . instantiate ()
julia > using Franklin
julia > serve ()
→ Initial full pass ...
→ evaluating code [ ... ] (learning / code - examples . md)
→ Starting the server ...
✓ LiveServer listening on https : // localhost : 8000 / ...
(use CTRL + C to shut down) 브라우저에서 localhost:8000 으로 이동하면 로컬로 만드는 모든 수정 사항을 미리 볼 수 있습니다.
CSS 수정 : _css/ 에서 관련 파일을 수정하십시오.
HTML 구조 수정 : Navbar 또는 바닥 글을 수정하려면 _layout/ 로 이동하여 관련 템플릿 조각을 수정하십시오.
방문 페이지 수정 : 랜딩 페이지에는 고유 한 디자인이 있으므로 적절한 경우 리포팅 가능한 조각을 몇 가지 삽입하여 HTML로 작성됩니다. index.html 만 수정하십시오.
폴더 구조 및 파일 구조 측면에서 다른 많은 블로그 게시물의 청사진을 따르십시오. 명심해야 할 중요한 것은 RSS가 받아 들일 수있는 측면에서 약간 까다 롭다는 것입니다.
@def rss = ...@def title = ...특히:
& 예를 들어 ML&PL ML-PL 로 변경하는 것과 같은 사용을 피하십시오.rss , 링크, 마크 업, HTML 엔티티가없는 일반 텍스트 만 사용하십시오. 의심스러운 경우 Franklin의 서버를 실행 한 후 __site/feed.xml 의 내용을 W3 피드 유효성 검사기에 복사하면 "유효한 RSS 피드"가 표시됩니다.
<meta aaa="bbb" content="ccc"> 블로그 게시물에 태그를 추가하려면 추가
@def meta = [( " aaa " , " bbb " , " ccc " ),](물론 여러 태그를 지정할 수 있습니다). 예를 들어 Keno의 최근 블로그 게시물을 참조하십시오.
마다 종종, 링크가 깨진 링크가 없다는 심층적 인 점검을해야합니다. Franklin 은이 작업을 빠르게 수행하는 방법을 제공하지만 때때로이 작업을 심도있게 수행하는 것이 좋습니다. 깨진 링크 체커 패키지는이 작업을 수행하는 매우 깔끔한 방법입니다. npm 으로 설치 한 후에는 그냥하십시오
blc https://julialang.org -ro
(시간이 걸리고 여러 단계로 수행해야 할 수도 있습니다).
Franklin은 구문 강조 표시에 Highlight.js를 사용합니다. 이 웹 페이지에서 사용하는 라이브러리에 새 언어를 추가하려면 라이브러리를 다시 컴파일하고 목록에 새 언어를 추가하십시오. 하이라이트의 루트에서 JS Repo :
$ node tools/build.js bash c diff javascript json julia julia-repl plaintext python ruby shell ini yaml
이 저장소에서 build/highlight.min.js 에서 라이브러리를 _libs/highlight/highlight.min.js 로 복사하십시오.
현재 빌드 미리보기는 Logan Kilpatrick의 Netlify 계정을 통해 실행됩니다. 계정이 오프라인 상태가되고 미리보기를 더 이상 사용할 수없는 경우 NetLify에 가입하고 Git 리포지토리 (이 repo)를 가져오고 "gh-preview"브랜치를 선택한 다음 사용자 정의 서브 도메인 "Julialang.netlify.com"을 선택하기 만하면됩니다. 그런 다음 그에 따라 미리보기를 빌드 할 수 있어야합니다.
이것은 대부분 레거시 항목입니다. 페이지에서 목록이 잘못 보이면 문제를여십시오. @@tight-list ... @@ 더 이상 사용할 필요는 없습니다.
중첩 목록을 원한다면 중첩 목록의 압입이 탭이 아닌 공백 으로 만들어 졌는지 확인하십시오.