Jenn의 기사를 HackMD로 편안하게 디자인

개시하다

젠은 지티허브 창고와 연대할 수 있기 때문에 같은 지티허브 창고 연대를 지원하는 해킹MD와 함께 문장을 편안하게 디자인할 수 없나요?라는 실험 보도가 나왔다.

주의점

이쪽의 디자인 방법은 Zenn이 공식적으로 추천한 방법이 아니니 스스로 책임지고 실시하세요.

HackMD 소개

HackMD는 온라인에서 Markdown을 이용해 필기를 받는 무료 웹 서비스다.동작이 수월하고 기록된 노트는 GiitHub의 협업을 통해 창고에 직접 저장된다.MD 파일로 추정할 수 있는 것이 특징입니다.
이 글에서 이 HackMD를 사용한 GiitHub 연합을 Zenn리(상) depro에서 보도하는 방법을 소개하고 싶습니다.

Zenn과 GiitHub의 콜라보

Zenn과 GiitHub의 합작 방법은 공식 홈페이지의 이쪽 보도를 참조하세요.
https://zenn.dev/zenn/articles/connect-to-github
아직 베타 버전과의 일이지만 간단하게 작업할 수 있어서 좋은 것 같아요.
여기에'zen-content'의 창고와 합작했다고 가정해 보자.

zenn CLI 설정

Zenn CLI를 설정하여 Zenn이 폴더 파일로 구성할 수 있도록 합니다.
Zenn CLI 설정은 공식 웹 사이트의 다음 기사를 참조하십시오.
https://zenn.dev/zenn/articles/install-zenn-cli

HackMD와 GiitHub의 콜라보

※ 해킹MD 계정의'설정'→'기타 서비스 허가'에서 자신의 깃허브 계정을 사전에 연합해야 합니다.

글 형식 만들기

Zenn의 글에는 다음 템플릿에서 시작하는 형식이 있는 것 같습니다.
HackMD 템플릿에 로그인할 수도 있습니다.

---
title: ""
emoji: "😸"
type: "tech" # tech: 技術記事 / idea: アイデア
topics: []
published: true
---

以下本文

title .. 기사 제목

emoji .. 글 제목에 사용되는 그림 문자(1자)

type .. tech: 기술 기사/idea: 아이디어

topics .. 표식["markdown", "rust", "aws"]처럼 지정

published .. 진:공개가짜:초고

published가 true로 바뀌면 그렇게 depro가 보도한다.
위 내용 이외에 일반적으로 Mardown으로 기재해도 상관없다.

보도를 설계하다

HackMD에 글을 쓴 후 편집 화면 오른쪽 위 메뉴에서 "GiitHub과 버전 동기화"를 선택합니다.

다음 모드를 시작하기 위해GiitHub에서 추력을 선택하십시오.(상관없어, "GiitHub로 밀어붙이기"지...)

줄 바꿈 규칙의 전환이라는 정보가 나타날 수 있기 때문에 줄 바꿈 규칙은 Mardown의 표준 규칙과 일치합니다.

줄 바꿈 규칙이 Mardown용으로 바뀌었기 때문에 줄 한 줄만 바꾸면 글이 줄 바꿈으로 표시되지 않기 때문에 글의 외관을 다시 확인하는 것을 추천합니다.
창고 선택 화면이 나오기 때문에 먼저 젠과 합작한 창고를 선택한 다음 지점을'마스터'로 설정합니다.

동기화할 파일을 선택할 때md 파일이 존재하지 않기 때문에 새 파일 이름을 추가합니다.여기에 지정된 파일 이름은 slug, 즉 Zenn의 글의 URL입니다.
버전명은 GiitHub이 제출한 정보로 쉽게 이해할 수 있도록 주석을 달아주세요.(내가 처음 디자인했을 때는first commiit였다.)
여기에는 두 가지 주의점이 있다.

GiitHub로 밀어붙일 때 고려 사항

articles/이하로 경로 지정하기

Zenn 해결 프로그램은 articles/ 경로의 바로 아래에 있습니다.MD 파일인 것 같습니다.(책의 경우books/)
따라서 파일 이름을 선택할 때articles/ 시작하는 경로를 지정합니다.

파일 이름은 반각 영문 숫자(a-z0-9)와 하이픈(-) 12~50자만 구성됩니다.

처음에는 파일 이름Article_Zenn_HackMD_Collaboration.md으로 처리하려고 했지만 다음과 같은 오류가 발생했습니다.

파일(slug) 이름이 그렇게 보도의 URL이 되기 때문에 파일 이름은 밑줄을 사용할 수 없고 반각영숫자와 하이픈의 조합이 필요하며 12~50개의 문자의 파일 이름을 사용해야 한다.
(대문자도 안 됩니다. 소문자만 가능)
마지막으로 맨 아래의'추'를 누르면 문장의 디버깅이 완성된다.
디버그가 성공하면 Zenn의 프로그램 메뉴가 디버그 성공으로 표시되어야 합니다.

끝말

나는 젠의 GiitHub 연합이 지금까지의 기술 보도 사이트에 없는 장점이라고 생각한다!
해킹MD에서 직접 디자인할 수 있어 편리한데 앞으로 소재가 생각나면 기사를 공개하고 싶어요.