프랭클린과 블로그를 만들다.jl

머리말

프랭클린jl는 간단하고 맞춤형 정적 사이트 생성기입니다.이것은 당신의 입맛에 맞게 수정할 수 있는 템플릿입니다. 이것은 매우 빠르고 효과적으로 사용됩니다.
프랭클린은 가볍고 사용하기 쉽다. 이것이 바로 내가 그것으로 블로그를 만들기로 결정한 이유이다.프랭클린은 다음과 같은 멋진 핵심 기능을 가지고 있다.

가격을 확대하여 유제와 유사한 명령을 정의할 수 있도록 한다.

사용자 정의 div 블록을 쉽게 포함할 수 있습니다.

KaTeX를 통해 나타난 수학, 하이라이트 인코딩을 통해.js (둘 다 미리 렌더링할 수 있습니다.)

줄리아 코드 블록의 실시간 평가.

수정된 실시간 미리보기입니다.

웹 사이트를 압축하고 미리 보여주는 간단한 최적화 절차.

사이트를 배치하는 간단한 발표 절차.

문화가 있는 사람과 직접 융합한다.jl.

프랭클린부터.

1. 환경을 구축한다.

프랭클린을 세우기 위해jl 환경:

운영 체제를 다운로드하여 설치Julia합니다.

Julia REPL을 엽니다.

명령 실행using Pkg.

명령을 사용하여 Franklin 설치

julia> using Pkg
julia> Pkg.add(Franklin)

2. 프로젝트를 시작합니다.

프로젝트를 시작하기 전에 Franklin이 제공하는 templates 목록을 읽고 사용할 템플릿을 알아보는 것을 권장합니다.템플릿을 만들고 홍보를 만들기로 결정할 수도 있습니다. (템플릿을 원한다면.)템플릿을 읽은 후 다음 명령을 실행합니다.

julia> using Franklin
julia> newsite("nameofsite", template="basic")

나는 블로그에서'기본'템플릿을 사용했다. 왜냐하면 나는 간단한 것을 좋아하기 때문이다!
이 작업을 완료하면 다음과 같은 메시지가 표시됩니다.

✓ Website folder generated at "nameofsite" (now the current directory).
→ Use serve() from Franklin to see the website in your browser.

그런 다음 서버 명령Pkg.add(Franklin)을 실행합니다.

julia> serve()
→ Initial full pass...
→ Starting the server...
✓ LiveServer listening on http://localhost:8000/ ...
  (use CTRL+C to shut down)

기본 브라우저에서 자동으로 열립니다.serve() 서버를 시작합니다.의존항을 추가하려면 그것을 포함하는 것이 좋습니다.

3. 프랭클린 유적지의 구조.

새 프로젝트의 구조는 다음과 같습니다.

├── .github 
├── _assets/
├── _css/
├── _layout/
├── _libs/
├── .gitignore
├── .gitlab-ci
├── 404.md
├── config.md
├── index.md
├── menu1.md
├── menu2.md
├── menu3.md
├── Project.toml
└── utils.jl

Project.toml 기능을 실행하면 serve() 폴더가 생성됩니다.Markdown에서 HTML로 생성된 웹 사이트입니다.이 폴더의 내용을 편집하지 말고 항목의 파일을 편집하십시오.__site 폴더의 변경 사항이 반영되지 않기 때문에 __site 파일에 포함되어 있기 때문입니다..gitignore 파일은 서버를 시작할 때 표시되는 페이지입니다.나머지 폴더는 지원 사이트의 보조 폴더입니다.

assets/이미지, 코드 세그먼트 등 포함

css/스타일시트가 포함되어 있습니다.

libs/에는 JavaScript 라이브러리가 있습니다.

layout/는 결과 페이지(예: 머리글 및 바닥글)에 HTML 프레임을 포함합니다.

index.md 페이지를 안내하는 데 도움이 되는 변수를 지정할 수 있습니다.전역 변수나 정의를 설명하고 모든 페이지에서 사용할 수 있습니다.이것은 매우 중요한 서류다.나는 문장의 뒤에서 더 많이 말할 것이다.config.md 폴더에 Github 작업에 사용되는 .github가 있습니다.사용자 정의를 위해 일부 필드를 설정할 수 있습니다.
방주: 페이지 내용을 변경하려면 deploy.yml,index.md,menu1.md와 menu2.md를 읽어서 표시를 어떻게 쓰는지 정확하게 이해하십시오.

4. 메뉴 편집 3.의학 박사.

config.md 폴더는 다음과 같습니다.

우선, 먼저 작가의 이름을 편집하면, 페이지 밑에 표시될 것이다.재구매 프로토콜을 사용하여 프로젝트 사이트를 만들려면 미리 경로를 정의해야 합니다.그리고 URL 경로는 config.md의 형식으로 그렇지 않으면 사이트의 CSS가 엉망으로 보일 수 있습니다.
너는 자신의 취향에 따라 사이트를 편집할 수 있다.제 블로그에 대해, 블로그, 연락처 페이지를 만들었습니다.블로그 부분에는 내가 이전에 쓴 문장이 포함되어 있다.그들의 자술 파일은 username.github.io/nameofrepo/ 폴더에서 찾을 수 있다.페이지의 CSS도 사용자 정의했습니다.

5. 포스트 프로세싱/링크 유효성 검사

Franklin은 GitHub을 여러 번 전송하지 않고 사이트의 링크가 정상적으로 작동하도록 하기 위해 이를 실현하는 기능을 제공했다.posts 검사에 사용합니다.
또한 Julia REPL을 닫고 프로젝트를 계속 처리하려면 서버를 다시 시작하는 것이 상당히 쉽다.항목이 있는 디렉토리로 이동하여 디렉토리 경로에 verify_links()를 입력합니다.
참고: Julia가 적용되려면 경로에 추가해야 합니다.

그런 다음 Julia REPL이 나타납니다.그런 다음 다음 다음 명령을 입력합니다.

julia> using Franklin
julia> serve()

6. GitHub로 밀어 넣습니다.

로컬에서 프로젝트를 완성한 후, 사람들이 당신이 하는 일을 볼 수 있도록 그것을 배치하기를 원할 것입니다.이것은 매우 쉽게 할 수 있다.GitHub 페이지에 배포할 수 있는 두 가지 방법이 있습니다.항목이 무엇인지에 따라 다릅니다.

개인 사이트julia 또는 조직 사이트(username.github.io).

프로젝트 사이트(orgname.github.io).

프로젝트 사이트를 고려할 때 (username.github.io/myWebsite/)에서 프로젝트 이름을 가진prepath 변수를 정의해야 합니다.예: config.md.이것은 배치할 때 사이트를 지시하는 기본 URL이 @def prepath = "myWebsite"이지 username.github.io/myWebsite/이다.만약 당신이 이렇게 하는 것을 잊어버린다면, CSS는 불러올 수 없을 것입니다. 당신의 사이트는 보기에 매우 나쁘고, 또 다른 문제가 있을 것입니다.
저장소와 로컬 폴더를 동기화하는 것이 우리의 다음 작업입니다.재구매 계약을 작성한 후 다음 명령을 입력합니다.

git init
git commit -m "first commit"
git branch -M main
git remote add origin https://github.com/Ifihan/nameofrepo.git
git push -u origin main

또는 초기화된 재구매에 대해 다음을 수행합니다.

git remote add origin https://github.com/Ifihan/nameofrepo.git
git branch -M main
git push -u origin main

너는 여기서 더 많은 Git에 관한 내용을 읽을 수 있다. site
* 참고 사항: *
GitHub에 익숙한 경우 다음과 같은 문제가 발생할 수 있습니다.

! [remote rejected] main -> main (refusing to allow a Personal Access Token to create or update workflow `.github/workflows/Deploy.yml` without `workflow` scope)
error: failed to push some refs to 'https://github.com/Ifihan/nameofrepo.git'

이것은 바로잡기 쉬운 작은 잘못이기 때문에 걱정할 것이 없다.컴퓨터에 등록된 영패에 작업 흐름 옵션이 없기 때문입니다.
새 영패를 생성하고 작업 흐름 옵션을 포함해서 이 문제를 복구할 수 있습니다.이동GitHub>설정>개발자설정>개인 방문 영패.그리고 "새 영패 생성"을 클릭

토큰의 이름을 입력하고 작업 흐름 기능을 선택하십시오.

[제어판 > 사용자 계정 > Windows 인증서 관리]로 들어가git 인증서를 찾습니다.

그것을 누르고 '삭제' 단추를 누르십시오.GitHub 키를 누르면 사용자 이름과 암호를 묻는 메시지가 표시됩니다.비밀번호 옵션에 생성된 영패를 넣으면 됩니다!
작업 부분으로 이동해서 배치될 때까지 기다립니다.gh 페이지라는 다른 지점도 찾을 수 있습니다.username.github.io 파일에 의하면 그것은 바로 거기에 배치된 것이다.

설정 > 페이지로 이동하고 지점을 홈페이지에서gh페이지로 변경하면 당신의 사이트가 성공적으로 관리됩니다!

나의 블로그는 https://ifihan.github.io/blogue/에 위치하고 있으며, 너는 GitHub에서 원본 코드를 찾을 수 있다.언제든지 스타가 되시고 PRs를 통해 공헌을 환영합니다.
줄리아는 새로 온 거야?내가 쓴 줄리아에 관한 글을 읽어라.
질문이 있으면 Slack 작업 영역의 #franklin 채널에서 물어보거나 DM에 보내주세요.너도 나에게 총을 쏠 수 있어 mail, 나는 기꺼이 돕겠다.