Zenn의 작문 체험을 가속화하는 별명 설정

9397 단어 ZennZenn CLIidea

개시하다


Zenn에서 GiitHub을 사용하여 글을 발표하고 버전을 관리할 수 있는 도구Zenn CLI를 제공합니다.Zenn의 가장 큰 특징은 브라우저 편집기에 얽매이지 않는 유연한 쓰기 환경을 구축할 수 있다는 것이다.이번에는 젠 CLI용 별명을 만들어 글을 쓰는 데 집중할 수 있는 환경을 만들었다.

별칭 목록 만들기


다음 별명은 기본 macOS 셸 Zsh에 사용됩니다.또한 글 디렉터리를 관리하는 경로는 환경에 따라 각각 다시 읽으십시오.동작은 WSL2(Ubuntu Zsh), 맥북(Zsh)을 통해 각각 확인했다.
.zshrc
# Zenn CLI用にに定義したエイリアスの確認用
alias agzenn='alias | grep zenn'
# Zennのコンテンツ管理に移動
alias zenn='cd ~/Documents/my-zenn-contents'
# Zennのコンテンツ管理ディレクトリに移動してVSCodeで開く & プレビュー表示
alias zennop='zenn && code ~/Documents/my-zenn-contents && npx zenn preview --open'
# 新しい記事をランダムなスラッグで作成
alias zennna='zenn && npx zenn new:article'
# 新しい記事をスラッグを指定して作成
alias zennnas='zenn && npx zenn new:article --slug'
# 新しい本をランダムなスラッグで作成
alias zennnb='zenn && npx zenn new:book'
# 新しい本をスラッグを指定して作成
alias zennnbs='zenn && npx zenn new:book --slug'
# ブラウザ上でプレビューを開く
alias zennpr='zenn && npx zenn preview --open'
# Zenn CLIのバージョン確認
alias zennv='zenn && npx zenn --version'
# Zenn CLIのアップデート
alias zennup='zenn && npm install zenn-cli@latest'

당장 집필환경 조성 전 연령


바로 젠의 집필을 진행하고 싶을 때 쓰는 별명을 정했다면 다음과 같다.이어져 있어 상당히 지저분하지만, 개인의 all in one 별명이 된다.
  • Zenn의 디렉토리로 이동
  • VScode를 통해 디렉토리 열기
  • 브라우저의 글 미리 보기
  • 순차적으로 집행하다.다음 별칭을 정의하여 바로 Zenn CLI를 사용하여 기사를 작성할 수 있습니다.
    .zshrc
    # Zennのコンテンツ管理ディレクトリに移動してVSCodeで開く & プレビュー表示
    alias zenn='cd ~/Documents/my-zenn-contents' # 共通処理 ディレクトリ移動
    alias zennop='zenn && code ~/Documents/my-zenn-contents && npx zenn preview --open'
    

    주안점


    Zenn CLI가 로컬에 설치되어 있으므로 기본적으로 npx 명령을 사용합니다.npx 명령을 실행할 때는 반드시 별명zenn으로 Zenn 내용 관리 디렉터리로 이동해야 합니다.

    컨텐츠 관리 디렉토리 액세스


    별명zenn을 설정하면 글을 관리하는 디렉터리(my-zen-contents)로 바로 이동할 수 있습니다.
    .zshrc
    # ドキュメントディレクトリ内にあるコンテンツ管理ディレクトリへアクセス
    alias zenn='cd ~/Documents/my-zenn-contents'
    
    이동 목적지에 절대 경로(전체 경로)가 지정되어 있기 때문에 어느 디렉터리에서 일하든지 zenn만 치면 바로 내용 관리 디렉터리로 이동할 수 있다.
    コンテンツ管理ディレクトリに移動する様子
    나는 젠의 글을 쓸 때 편집자Visual Studio Code를 이용해 젠의 글을 썼다.VScode의 장점은 지정한 디렉터리를 VScode에서 순식간에 열 수 있는 Code 명령이 있다는 것이다.이전에는 Zenn 기사에서 코드 명령을 요약했습니다.
    https://zenn.dev/ryuu/articles/what-vscodecommand
    VScode는 다음 명령을 사용하여 다른 디렉토리에서 작업하는 경우에도 Zenn의 컨텐츠 관리 디렉토리를 즉시 엽니다.
    # Zennのコンテンツ管理ディレクトリをVSCodeで開く
    $ code ~/Documents/my-zenn-contents
    

    문장과 책의 미리보기


    VScode는 기본 커서 미리 보기 기능을 가지고 있기 때문에 현장에서 커서 파일 (.md) 을 미리 보고 쓸 수 있습니다.그러나 Zenn에는 Zenn만의 표기법(정보, 아코디언, 모서리)이 있어 VSOCde의 미리보기 기능을 완전히 미리볼 수 없다.따라서 Zenn CLI에는 Zenn Editor가 있으며, 투고하기 전에 localhost에서 서버를 시작한 후 Zenn에 표시되는 방법을 확인할 수 있습니다.열중재에 대응하기 때문에 현지의 변경을 순간적으로 반영하면서 글을 쓸 수 있다.
    $ npx zenn preview
    
    실행 후 브라우저에서 방문localhost:8000할 때ZennEditor가 시작되면 브라우저의 외관을 실시간으로 확인할 수 있습니다.
    이 기능을 간단하게 호출하기 위해 별명zennpr을 설정했습니다.별명을 사용하면 글의 미리보기 명령npx zenn preview을 간소화하고 시간을 단축할 수 있다.
    별명에 미리보기 명령 외에 --open 옵션이 추가되었습니다.
    .zshrc
    # 記事と本のプレビュー
    alias zennpr='zenn && npx zenn preview --open'
    
    공식 문서에는 상세한 설명이 없지만, 여기에 --open 옵션을 추가하면 기본 브라우저의 미리 보기 화면이 자동으로 열립니다.별명(위)에 미리 - 오픈 옵션을 포함하면 바로 미리 볼 수 있습니다.현지에서 글을 수정할 때 바로 글의 외관을 확인할 수 있어 매우 편리하다.

    새로운 문장과 서적을 쓰다


    Zenn CLI를 사용하여 새 기사·책을 만들 때의 명령npx zenn new:articlezennna,npx zenn new:bookzennnb입니다.문장과 책은 별명 뒤에 있는 문자(new:article, new:book)를 각자의 자모로 만들어 이해하기 쉽다.문장은 찌꺼기 (임의의 문장 이름) 를 지정할 수 있으며, 만약 npx zenn new:article 라면, 문장은 무작위 속담에서 만들어진다.인터럽트를 설치할 때 명령 뒤에 각각 --slug 옵션을 추가하면 임의의 인터럽트를 추가할 수 있습니다.나는 매 문장마다 개별적인 비속어를 덧붙여 관리하기 때문에 zennnas,zennnbs처럼 비속어 옵션(-slug)을 포함하는 별명도 정의했다.
    .zshrc
    # 新しい記事をスラッグを指定して作成
    alias zennnas='zenn && npx zenn new:article --slug'
    
    # 新しい本をスラッグを指定して作成
    alias zennnbs='zenn && npx zenn new:book --slug '
    
    계속 별명을 붙이면 계속 붙이고 싶은 비속어만 간단하게 오리지널 비속어를 더해 글을 쓰기 시작해 편리하다.
    $ zennnas alias-of-zenncli(任意のスラッグ)
    
    비속어 이외에 그림문자, 제목, 책 판매가격 등 제작 시 이용할 수 있는 옵션이 많으니 자세한 내용은 아래 공식 글을 참고하시기 바랍니다.
    https://zenn.dev/zenn/articles/zenn-cli-guide

    총결산


    이번에는 젠이 집필할 때 활용한 별명을 소개한다.
    Zenn CLI·ZennEditor는 Zenn만의 기능으로 혁신적인 느낌을 준다.이 글쓰기 체험이 더 나아질 수 있도록 별명 등을 활용해 유연하게 사용자 정의를 함으로써 글쓰기에 더 집중할 수 있는 환경을 만들었다.
    이번에 소개된 별명은 집필에서 여러 차례 사용된 지령이기 때문에 별명의 정의를 간략화하고, 목적에 집중할 수 있는 글을 쓸 수 있는 환경을 조성한다는 개념으로 고려됐다.개인의 운용이기 때문에 가장 좋은 실천이라고 할 수는 없지만 참고하기 편한 정도로 설정해 보세요.
    끝까지 읽어주셔서 감사합니다.

    참고 자료

  • Zenn CLI 설치
  • Zenn CLI로 기사·문서 관리 방법
  • Zenn의 Mardown 기재법
  • 좋은 웹페이지 즐겨찾기