Writing work metadata added

Author: arctrong

doc/content/sections/reference.html

@@ -287,6 +287,24 @@ <h1 id="argument-file-structure">Argument file structure</h1>
 </thead>
 <tbody>
 <tr>
+<td>title*</td>
+<td>string</td>
+<td align="center">No</td>
+<td>Writing work title</td>
+</tr>
+<tr>
+<td>logo*</td>
+<td>string</td>
+<td align="center">No</td>
+<td>Logo image (relative the the project root)</td>
+</tr>
+<tr>
+<td>home-page*</td>
+<td>string</td>
+<td align="center">No</td>
+<td>Writing work start page (relative the the project root)</td>
+</tr>
+<tr>
 <td><a href="#options_section">options</a></td>
 <td>object</td>
 <td align="center">No</td>
@@ -312,6 +330,8 @@ <h1 id="argument-file-structure">Argument file structure</h1>
 </tr>
 </tbody>
 </table>
+<p>* As for now, the "title", "logo" and "home-page" properties are not processed by the program.
+This metadata may be used by other programs, e.g., for cataloguing purpose.</p>
 <p><a name="options_section"></a></p>
 <h2 id="options-section"><code>options</code> section</h2>
 <p><a href="#section_list"><img alt="" src="../../pict/triangle_up_h18px.png" /></a> <a href="#section_list">to section list</a></p>

doc_src/sections/reference.txt

@@ -185,17 +185,23 @@ _Argument file_ format is JSON [<!--ref json-->].
     For example, if `"plugins"` is replaced with `"plugins1"` then all plugins will be disabled.
     Still the _argument file_ format defines necessary elements and other rules that will
     be checked before processing.
-    
+
 <a name="section_list"></a>
 The following is the detailed _argument file_ format description by sections:
 
 Name | Type | Required | Description
 ---- | ---- | :----: | ----
+title\* | string | No | Writing work title
+logo\* | string | No | Logo image (relative the the project root)
+home-page\* | string | No | Writing work start page (relative the the project root)
 [options](#options_section) | object | No | Options for the whole program run
 [default](#default_section) | object | No | Default options for the documents
 [documents](#documents_section) | array of objects | Yes | Documents that will be processed
 [plugins](#plugins_section) | object | No | Plugins that will be used for the documents processing
 
+\* As for now, the "title", "logo" and "home-page" properties are not processed by the program.
+This metadata may be used by other programs, e.g., for cataloguing purpose.
+
 
 <a name="options_section"></a>
 ## `options` section

java/src/main/java/world/md2html/options/model/raw/ArgFileRaw.java

@@ -13,6 +13,10 @@
 @Builder(toBuilder = true)
 @JsonDeserialize(builder = ArgFileRaw.ArgFileRawBuilder.class)
 public class ArgFileRaw {
+    String title;
+    String logo;
+    @JsonProperty("home-page")
+    String homePage;
     ArgFileOptionsRaw options;
     @JsonProperty("default")
     ArgFileDocumentRaw defaultSection;

java/src/main/resources/args_file_schema.json

@@ -2,6 +2,9 @@
     "$schema": "http://json-schema.org/draft-04/schema#",
     "type": "object",
     "properties": {
+        "title": { "type": "string" },
+        "logo": { "type": "string" },
+        "home-page": { "type": "string" },
         "options": {
             "type": "object",
             "properties": {

md2html_args.json

@@ -1,4 +1,7 @@
 {
+    "title": "MD2HTML",
+    "logo": "doc/favicon.png",
+    "home-page": "readme.html",
     "options": {
         "verbose": true
     },

python/args_file_schema.json

@@ -2,6 +2,9 @@
     "$schema": "http://json-schema.org/draft-04/schema#",
     "type": "object",
     "properties": {
+        "title": { "type": "string" },
+        "logo": { "type": "string" },
+        "home-page": { "type": "string" },
         "options": {
             "type": "object",
             "properties": {