Home

Welcome to the vtdiscourse wiki! 這裡將介紹 vtdiscourse 支援格式。

格式

法案的原始檔案是採用 markdown 語法建立而成，而 vtdisocurse 作法就是根據指定的名稱連接到 g0v 對應的的 repo，接著就是根據 SUMMARY.md 遞迴去 parser 出要轉出的 markdown 文件。

REPO 結構

一個法案的結構會是如何先介紹，這邊我們以企業資產擔保法的 repo securitization-gitbook 來看：

securitization-gitbook
├── 1.md
├── GLOSSARY.md
├── LICENSE.md
├── README.md
├── SUMMARY.md
├── book.json
├── gulpfile.js
├── lexicon.json
└── package.json

這是一個 repo 的樹狀結構，vtdiscourse 會讀取 SUMMARY.md 和 package.json 兩隻檔案。 package.json 能夠取得法案中文名稱。 SUMMARY.md 能夠取得各內容的檔案名稱。

Markdown 檔案結構

以這個範例有 README.md 與 1.md 兩隻檔案列在 SUMMARY.md 內。除了 README.md 這隻檔案外，其餘就是要上稿的類別(Category)和討論項目。簡單說明上稿的結構是一個四層架構：

法案名稱(1)
├── 1.md h1 名稱(1.1)
│   └── 1.md h2 名稱(1.1.1)
│       ├── 1.md h2 底下所有內容(1.1.1.1)
│       ├── 1.md h2 底下所有內容(1.1.1.2)
│       ├── 1.md h2 底下所有內容(1.1.1.3)
│       └── 1.md h2 底下所有內容(1.1.1.4)
└── 2.md h1 名稱(1.2)
    └── 2.md h2 名稱(1.2.1)
        ├── 2.md h2 底下所有內容(1.2.1.1)
        └── 2.md h2 底下所有內容(1.2.1.2)

以企業資產擔保法 1.md 內容為例：

# 立法之必要性
--> h1(1.1)

2016年10月，世界銀行發布《2017經商環境報告》「法定權利指數」調查，於190個經濟中，具有整合統一動產債權擔保法制的國家有50個，包括：紐西蘭、澳洲、美國、加拿大、哥倫比亞及祕魯等國。另一項調查：「法律是否允許企業將其全部資產，設定不移轉占有擔保權，而無要求具體描述擔保標的內容？」，則達150個經濟體有此制度，包括鄰近紐西蘭、新加坡、香港、馬來西亞、中國大陸、越南及蒙古等，而臺灣並沒有此擔保制度。

我們認為，可考慮另定「企業資產擔保法草案」的方式，以補強現行擔保法制缺乏或不足部分。

為了行政及立法機關，能瞭解各界對制定企業資產擔保法草案之需求，擬定以下4個問題徵集民眾意見，做為後續政策分析參考。
--> h1 內容

## 現行動產及債權擔保法制有何問題？
--> h2(1.1.1)

我國現行擔保法制，採用類型化區分：

* 依民法物權設定不動產抵押、動產或權利質權
* 依動產擔保交易法設定動產抵押、附條件買賣及信託占有
* 依智慧財產權相關法律分別設定質權

在這樣未統整的擔保法制架構下，企業不能用流動性的資產（如存貨）設定浮動擔保權。尤其是新創事業或中小企業，難以其現有全部資產設定擔保、取得融資。此外，在分割資產類別、區分型態的登記方式下，往往會造成企業的整體綜效價值被低估，並增加辦理設定擔保登記的複雜度。

我國現行擔保法制，也不承認以下標的設定擔保權：

* 企業未來取得的動產、債權（如未來應收帳款）
* 無形資產（如非法定財產權之商業模式，或具高人氣流量的網站、企業數據資料庫）

如此一來，相當不利中小企業及新創事業（如網路公司）、新興產業（如物聯網、綠能光電）、文化創意產業（如影視音產業）取得有利的融資條件：如較低的利率、較長的還款期限、較多的資金等。

請問你是否贊成，臺灣需要符合便利企業取得融資，並與國際擔保法制接軌的動產擔保交易法？

無論贊成與否，都歡迎寫下你的理由。
--> h2 內容(1.1.1.1)

各階層在 talk vTaiwan 代表分類：

• 父分類(Category)：法案名稱（英文名字）
• 子分類(Category)：h1
• 討論項目(Topic)：h2
• 討論內容(Content)：h2 下內容

所以一個法案底下就會有 n 個 h1 子分類，每個 h1 底下有 m 個 h2 項目與內容，在 talk vTaiwan 就會如這樣

但因為法案名稱在讀取 package.json 時就會建立父分類，因此在建立一個法案的內容格式需要三階層結構如下：

# h1 header
內容

## h2 header
內容

## h2 header
內容