GitHubwikiディレクトリ


85

GitHubリポジトリとともにインストールされるWikiはディレクトリをサポートしていますか?私たちのウィキはページが散らかっていて、それらをよりよく整理する方法を探しています。

リポジトリをプルし、ローカルディレクトリを作成し、物事を移動しようとしましたが、コミットして戻すと、wikiは変更を取得しませんでした。

回答:


60

私はまったく同じ問題を抱えていて、あなたが試したものの変形を試しました。何もスタックしていません。それについてGitHubサポートに質問し、基本的に「いいえ。ただし、開発者にこの機能に関心があることを通知します」という返信を受け取りました。

したがって、短い答えは「いいえ」であり、長い答えは「いいえ、しかし将来的には」です。


8
現在の短い答えは「はい」です。:)
マルコ

2
@Marco 3年後?GitHubは、ユーザーのリクエストを真剣に受け止めています。:|
trejder 2015年

9
はい、まだありません、5年後
リンカーンベルゲソン2017

1
6年。ところで、#Microsoftについてうめき声を上げている人々が#GitHubをオフィスに戻したのを聞いた。今日はがっかりしすぎて、今は笑えると思います。
DevOvercome 2018年

我々は、このようにそれを行うことができますdocs.gitlab.com/ee/user/project/wiki
アムリタデブ

30

実際、githubが最近ディレクトリのサポートを追加したようです。

私は次のことができました:

  • 既存のマークダウンファイルを新しいディレクトリに移動します。
  • 既存のディレクトリ(前の手順で作成)に新しいマークダウンファイルを作成します。
  • 新しいディレクトリに新しいマークダウンファイルを作成します。

すべての場合において、既存のページはまだそこにあり、新しいページが追加されました。

残っている1つの制約は、ファイル名が一意である必要があるということです。同じ名前のファイルが複数ある場合は、そのうちの1つだけがwikiに表示されます(どちらかはわかりません。


9
つまり、基本的には、ページを整理するためだけのものですが、それ以上のものはありません。
ルネ・ポット

26

GitHub wiki(別名Gollum)はディレクトリを使用しますが、期待する方法では使用しません。

Gollum wikiのドキュメントはいくつかの作業を使用する可能性がありますが、これは私が主にテストを通じて理解したものです。

  • すべてのファイルは、リポジトリ内のどこに配置されていても、Wikiのルートに表示されます。
  • _Header_Footerおよび_Sidebarファイルはディレクトリごとですが、子フォルダにファイルが存在しない場合は継承されます。
  • ファイルリンクは、ソースファイルに相対的である可能性があります(ファイルをコンテンツと一緒に保持します)。

したがって、名前空間用のディレクトリが必要な場合は、運が悪いことになります。{namespace}-{page}名前空間のスキームの使用を検討してください。


7
サブページがないため、GollumとGitHub wikiは、ひいては機能不全の「wiki」になっています。

14

これは理想的なソリューションではありませんが、回避策は、ページへのリンクを含む目次を作成するカスタムサイドバーを作成することです。とにかく、これは複数の階層の下にある単一のページへのリンクを持つことができるため、フォルダーよりも優れていると思います。


それは私が取ったアプローチですが、それはページの巨大な混乱である「ページ」の部分を残します(私のプロジェクトでは60以上)。
ジェイソンショート

ありがたいことにサイドバーが乱雑にならないように、ページ部分が折りたたまれています
pd12 2016年

1

実際には、まだ制限があります。はい、1つのレベルを追加できます(つまり、1つのサブフォルダー)。しかし、それだけです!ドキュメントのレイアウト全体をリファクタリングして、組織用に複数のレベルのサブフォルダーを作成しましたが、それは失敗でした。

はぁ

私は言わなければなりません:私はこのゴラムの事に愕然としています。Githubがそれを拾ったのにも驚いています。


2
これは正しくないと思います。gitが推奨するwikiサイトの1つであるgithub.com/showcases/projects-with-great-wikisを見ていました。私はgitクローンを作成しましたが、少なくとも3つのレベルのサブディレクトリがあることを確認しました。たとえば、technical-documentation / 1-trackers / ruby​​-trackerを見てください。
エドオスト2014

わかりました。自分でテストしましたが、リンクテキストと同じ名前のサブディレクトリにゴラムに問題があるようです。これは一種の奇妙なことです。実際のページ名に衝突があったかどうかはわかりますが、mediaWiki構文[[Link Text | WikiPage]]を使用すると、リンクテキストと実際のディレクトリ名が混同されているように見えます。
エドオスト2014

この信じられないほど醜く冗長なフォーマットは機能しているようです[PageName](PageName)
Ed Ost

1
gollum-libでは、ページ名にスラッシュを付けることができます。これは、期待どおりに動作します。残念ながら、GitHubも「公式の」SinatraベースのGollumフロントエンドもこれらを賢明にサポートしていません。
gerwitz 2014年

1
EdOstのコメントにあるそのgithubショーケースはもう存在しません。代替FWIW quora.com/...
simesy
弊社のサイトを使用することにより、あなたは弊社のクッキーポリシーおよびプライバシーポリシーを読み、理解したものとみなされます。
Licensed under cc by-sa 3.0 with attribution required.