KM寫作教學

簡介XDM KM平台以及寫作文件的方法和工具

KM平台簡介

KM平台為靜態網站,使用HEXO建置,可以輕易建立在各種環境。

在主畫面上方為選單列

  • 首頁: 顯示近期文章以及文章的簡介

  • 歸檔: 以清單方式用日期排序顯示文章標題

  • 標籤: 顯示所有文章標籤

  • 分類: 顯示所有文章分類

  • 搜尋: 搜尋工具,可搜尋標題以及內文

KM

文章畫面左邊為主要內容,右方為章節列,可快速跳選文章位置

KM

寫作工具

文件的寫作語法為Markdown,相關語法可以參考Markdown教學

提供線上以及本機的工具供參考

線上: StackEdit

本機: Visual Studio Code

StackEdit

線上版Markdown編輯器,主畫面左邊為語法編輯區右邊為預覽區,左上方提供檢視格式工具幫助產生語法

StackEdit

Visual Studio Code

微軟提供的輕量級編輯器,支援多種語法包含Markdown

打開md文件後在右上方可以找到預覽按鈕,可以顯示預覽畫面

vscode

vscode

寫作方法

使用VsCode當作範例建立一份文章。

建立文章儲存區

建立一個資料夾,md檔以及你文章內所有會連結到的圖片以及檔案將會放在同一個資料夾下

一個資料夾只會有一個md檔也代表一篇文章

step

使用VsCode編輯

可以在主畫面選擇開啟資料夾或著從左上方選單的檔案裡選擇開啟資料夾功能

step

step

文章格式

因為要規範文章分類以及標籤等內容,有些預設的文章格式需要遵守

下面提供範本

---
title: Sample
date: 2018-04-25 18:04:19
updated: 2018-04-30 18:04:19
categories: 
- [其他文件, Sample]
tags:
- 其他文件
- 其他文件2
---

> Author:Sid

![logo](logo.png)

more以上的內容為文章縮寫內容,more以下會在文章內容出現

<!-- more -->

其他內容
  • title: 標題名稱
  • date: 寫作建立日期
  • updated: 寫作更新日期
  • categories: 可以為單一分類,也可以多個分類,也可以多層階級關係

有階層關係使用方括號[ 分類1, 分類1-1 ],類似此方法

step

  • tags: 文章標籤,可多個
  • > Author: 填寫文章作者
  • <!-- more -->: 文章縮寫分界線,建議要使用
  • 貼圖語法由於檔案跟md檔在同一目錄,所以語法直接填寫檔案名稱![logo](logo.png)預覽就可以直接看到圖

step

壓縮寄出

文章寫好後應該會準備好一個資料夾裡面放著md檔以及圖片、附件,然後將整個資料夾壓縮後寄出至XDM PD組,暫由PD負責上架。