😸

アカウントにGitHubリポジトリを連携してZennのコンテンツを管理する

に公開
15

Discussion

oliveroliver

オンラインエディタで公開した記事をGitHubのリポジトリに移行し、記事の内容を編集したいのですが、どのようにすればよろしいでしょうか?

手元ではリポジトリと既に連携済みで、オンラインエディタで作成した記事を編集しようとすると「GitHub連携しています。リポジトリで編集を行ってください」と出てしまいます。

Zenn公式Zenn公式

こちらさきほど修正を行い、GitHubリポジトリ連携していてもブラウザ上でエディターを開けるようにしました。
現状では本文をコピペしていただくことになります。お手数ですが、よろしくお願いします。

まったまった

連携中に記事のオンラインエディタでの記事の編集はできても新規作成はやはりできないのですね🤔

  • 編集後も当然対応する記事 .md ファイルを push すると上書きされる。
  • スクラップの作成は可能
結城浩 / Hiroshi Yuki結城浩 / Hiroshi Yuki

どのようなMarkdownファイル名を付けたら第何章に対応するファイルになるのか、どのドキュメントを見ればわかるでしょうか。

Zenn公式Zenn公式

現時点ではチャプター番号.mdというファイル名にのみ対応しています。
3.mdは第3章に対応するというイメージです。

ドキュメント:CLIで本(book)を管理する

ただ、後から間にチャプターを差し込みたくなった場合にリンクの維持ができないので、今後このissueのようなアイデアで対応できないか検討しています。

ChiYoChiYo

オンラインエディタで公開した記事をGitHubのリポジトリに移動したいのですが、
touchコマンドでオンラインエディタに公開されているものと同じsligのmdファイルを作成し、
内容をコピペしてGitHubにpushする…とういう方法で合っているでしょうか?

Zenn公式Zenn公式

はい、2021年2月ではそのような形を取っていただく必要があります。まだしばらく時間はかかると思いますが、ZennからGitHubへのコミットもしくはプルリクエストの作成に対応したいと考えています。

さのたけとさのたけと

コンテンツをコピペして同名の slug を作って上書きする方法で,ウェブ上で作成していた本を GitHub に移したのですが,チャプターの数が多かったので大変でした.「設定内容を YAML で出力」という機能はありますが,コンテンツも含めてディレクトリを zip でダウンロードできる機能があると移行がしやすくなるかなと思いました(Zenn から GitHub へのプッシュがあれば理想的ですが,それができるまでの暫定対応として).

MzRyuKaMzRyuKa

GitHub連携をしようとすると、「必要なパラメータが存在しません」というエラーメッセージが出てきます。
Organizationsのprivateリポジトリを指定しているのですが、これが関係しているのでしょうか?

MzRyuKaMzRyuKa

いや、何かしらの権限が不足していただけっぽいですね。
取り急ぎ、リポジトリに対して「setting」ができる場合は、Organizations管轄のリポジトリでも問題なく連携できました。

MzRyuKaMzRyuKa

リポジトリに対して「setting」ができる場合は
正確ではなかった。結局のところ、Admin権限が必要だったというオチでした。

toshiki.chotoshiki.cho

連携済みのGitHubリポジトリに複数人が記事をpushした場合、コンテンツの作成者はどうなりますか?
コンテンツごとに作成者が反映されますか?

Zenn公式Zenn公式

その場合、コンテンツの作成者は、GitHubリポジトリを連携しているアカウント(ユーザー)になります。

toshiki.chotoshiki.cho

ご回答ありがとうございます。
この仕様はPublicationでも同様でしょうか?

Zenn公式Zenn公式

Publicationは、Publicationに所属するユーザーがPublicationに記事を投稿する形となります。
PublicationとGitHubリポジトリが連携しているわけではありません。

Publicationは無料でお使いいただけますので、ぜひさわってみてください。