私はまだ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
私はいくつかのハードルがあります。もちろん、上記
- 構造
- 私たちのMDファイルが上がりませんフロントマントを使用するのではなく、
<!-- @@@title:Dashboard [email protected]@@ -->
がマークダウンファイルの先頭にあります。私はちょうどperl -i -pe 's/<\!-- @@@(title:)(.*?)@@@ -->/---\n$1 $2\n---\n/g' *.md
のような何かをすることができましたが、より洗練された解決策があるかどうかは分かりませんでした。 - イメージリンクも変換する必要があります。私たちのファイルでは、彼らはそのように行われています。
![Controls](@@path/images/controls.png)
を誰かがウェブサイト上で、彼らが自動更新、私たちは私たちのドキュメントを更新するときように、この簡単-repleatableプロセスにするために使用できる方法を提案することはできますか?
Ty。質問: '_docs'の中にこれらのディレクトリをすべて持っていれば、' _config.yaml'にそれらをアクセス可能にするために何を追加する必要がありますか? 'foreach'ループでどのようにそれらにアクセスするのですか? –
なぜdocsだけでなく_docsですか? pages変数を使用してループすることができます。パスでフィルタリングするだけです – Christian