2017-06-04 7 views
0

私はまだJekyllを学んでいますが、私たちのドキュメントを更新するときにドキュメントにアクセスできるように私たちのドキュメントを移植しようとしています。理想的には、できるだけシームレスにしたいと思っていました。当社の製品ドキュメントは、すでにた.md形式でレイアウトされ、ツリーは次のようになりますされていますサブディレクトリからJekyllコレクションファイルにアクセスする

├── 01_Using_The_Dashboard 
│   ├── 01_Dashboard_Overview.md 
│   ├── 02_Widgets_Overview.md 
│   ├── 03_Pre-built_Widgets.md 
│   ├── 04_Creating_your_own_widgets.md 
│   ├── 05_Search_Syntax.md 
│   ├── 06_Dashboard_Import_Export.md 
│   ├── images 
│   │   ├── [email protected] 
│   │   ├── [email protected] 
│   │   ├── [email protected] 
│   │   ├── [email protected] 
│   │   ├── [email protected] 
│   │   ├── [email protected] 
│   │   ├── [email protected] 
│   │   ├── [email protected] 
│   │   ├── [email protected] 
│   │   ├── [email protected] 
│   │   ├── [email protected] 
│   │   ├── [email protected] 
│   │   ├── [email protected] 
│   │   ├── [email protected] 
│   │   ├── [email protected] 
│   │   ├── [email protected] 
│   │   ├── [email protected] 
│   │   ├── [email protected] 
│   │   ├── [email protected] 
│   │   ├── [email protected] 
│   │   └── [email protected] 
│   └── index.md 
├── 02_Creating_Triggers 
│   ├── 01_Trigger_Page.md 
│   ├── 02_Explanation_of_Actions.md 
│   ├── 03_Trigger_Scripts.md 
│   ├── images 
│   │   ├── add-new-trigger.png 
│   │   ├── [email protected] 
│   │   ├── [email protected] 
│   │   ├── [email protected] 
│   │   ├── [email protected] 
│   │   ├── [email protected] 
│   │   ├── [email protected] 
│   │   ├── [email protected] 
│   │   └── [email protected] 
│   └── index.md 
├── 03_Alerts 
│   ├── 01_Alerts_Overview.md 
│   ├── 02_Automations.md 
│   ├── 03_Trigger_Import_Export.md 
│   ├── 04_Outgoing_Webhooks.md 
│   ├── images 
│   │   ├── add-new-trigger.png 
│   │   ├── filters-hosts.png 
│   │   ├── filters-severities.png 
│   │   ├── outgoing_webhooks.png 
│   │   ├── slack_alert.png 
│   │   └── triggers.png 
│   └── index.md 
├── 04_Backend_Administration 
│   ├── 01_Receiving_Syslog_Events.md 
│   ├── 02_Sending_Email_From_The_Server.md 
│   ├── 03_Archive_and_Restore.md 
│   ├── 04_Server_Licensing.md 
│   ├── 05_Using_TLS_Tunnels.md 
│   ├── 06_Using_HTTPS.md 
│   ├── 07_Backend_Configuration_Options.md 
│   ├── 08_Backend_Search_Settings.md 
│   ├── 09_Migrating_LogZilla_To_A_New_Server.md 
│   ├── images 
│   │   └── smtp.png 
│   └── index.md 
├── 05_Software_Notes 
│   ├── 01_Development_Lifecycle.md 
│   ├── 02_Release_Notes.md 
│   ├── 03_LogZilla_VMWare_Image.md 
│   ├── images 
│   │   └── ticketflow.png 
│   └── index.md 
├── 06_Performance_Tuning 
│   ├── 01_UDP_Buffer_Tuning.md 
│   ├── 02_CPU_Frequency_Governers.md 
│   ├── 03_VMWare_Performance.md 
│   ├── 04_Filesystem_Performance.md 
│   ├── images 
│   │   └── vmware-disk-priority.png 
│   └── index.md 
├── 07_Receiving_Data 
│   ├── 01_Receiving_SNMP_Traps.md 
│   ├── 02_Cisco_IOS_Configuration.md 
│   ├── 03_Receiving_Rsyslog_Events.md 
│   ├── 04_Debugging_Event_Reception.md 
│   ├── 05_Incoming_Webhooks.md 
│   ├── 06_Receiving_Windows_Events.md 
│   ├── images 
│   │   ├── snare-001.png 
│   │   ├── snare-002.png 
│   │   ├── snare-003.png 
│   │   └── snare-004.png 
│   └── index.md 
├── 08_Event_Correlation 
│   ├── 01_Intro_to_Event_Correlation.md 
│   ├── 02_Event_Correlation_Rule_Types.md 
│   ├── 03_Sample_Rules.md 
│   ├── 04_Correlating_Windows_Events.md 
│   ├── images 
│   │   ├── cisco-ec-mne.png 
│   │   ├── cisco-ec-save.png 
│   │   └── cisco-ec.png 
│   └── index.md 
├── 09_API 
│   ├── 01_Using_The_API.md 
│   └── index.md 
└── template.html 

私はいくつかのハードルがあります。もちろん、上記

  1. 構造
  2. 私たちのMDファイルが上がりませんフロントマントを使用するのではなく、<!-- @@@title:Dashboard [email protected]@@ -->がマークダウンファイルの先頭にあります。私はちょうどperl -i -pe 's/<\!-- @@@(title:)(.*?)@@@ -->/---\n$1 $2\n---\n/g' *.mdのような何かをすることができましたが、より洗練された解決策があるかどうかは分かりませんでした。
  3. イメージリンクも変換する必要があります。私たちのファイルでは、彼らはそのように行われています。![Controls](@@path/images/controls.png)

を誰かがウェブサイト上で、彼らが自動更新、私たちは私たちのドキュメントを更新するときように、この簡単-repleatableプロセスにするために使用できる方法を提案することはできますか?

答えて

0

1)上記の構造は問題ありません。 "_posts"ディレクトリには追加しませんが、ルートフォルダには直接追加します。あなたが生成されたパーマリンクに満足できない場合、あなたは常にFrontmatterでこの設定を上書きすることができます

01_Using_The_Dashboard/01_Dashboard_Overview.html 

:それはその後のようなファイルを生成する必要があります。

2)私は$ x2frontmatterのツールを知らない。私が知る限り、ワードプレスから移行するための何かがあります。私は、あなたのperlのソリューションはおそらく、このような変換を行う最もエレガントな方法だと思います。 「レイアウト:ページ」などの追加コンテンツを生成することも考えてください。それ以外の場合は、後で更新する必要があります。

3)@@パスの代わりに、ベースURLを使用できます。 Parkers postをご覧ください。さらに詳しい情報が含まれているvariables sectionもご覧ください。

第4の質問については、変更を自動展開する方法を知りたいと思うようです。継続的な展開と同じです。それを行うには複数の方法があります。

  1. ここには、rsync, crontab and shellを使用して自動配備したブログ記事があります。
  2. deploying to S3(アセットを含む)の詳細については、こちらのブログ記事をご覧ください。
  3. GitHubにデプロイするオプションもあります。 GitHub Pagesのドキュメントをご覧ください。

個人的に私はCloudFront/S3オプションを使用します。

+0

Ty。質問: '_docs'の中にこれらのディレクトリをすべて持っていれば、' _config.yaml'にそれらをアクセス可能にするために何を追加する必要がありますか? 'foreach'ループでどのようにそれらにアクセスするのですか? –

+0

なぜdocsだけでなく_docsですか? pages変数を使用してループすることができます。パスでフィルタリングするだけです – Christian

関連する問題