T.scholze/28 config file (#29)

Author: tscholze

README.md

@@ -33,10 +33,12 @@ Clone the [kotlog-template repository](https://github.com/tscholze/kotlin-kotlog
  -g                     :  Generates HTML output
  -p                     : Publish aka pushes changes to remote
  -co                    : Clears the output
+ -cc                    : To create a new configuration file
 ```
 
 ## Configuration
 
+### Using configuration instance
 A Kotlog-generated blog ist configurated using the `BlogConfiguration` parameter of the `Kotlog` invocation.
 See `Main.kt` for a working example:
 
@@ -54,8 +56,20 @@ fun main(args: Array<String>) {
 }
 ```
 
+### Using configuration file
+Otherwise, Kotlog will try to load the configuration file (`~/.kotlog`) from the file system. Run `./kotlog -cc` to create a new file.
+
+```json
+{
+    "baseUrl": "https://tscholze.github.io/blog",
+    "titleText": "Tobias Scholze | The Stuttering Nerd",
+    "footerText": "Made with ❤️ without JavaScript| Kotlog | Tobias Scholze",
+    "outputDirectoryName": "www"
+}
+```
+
 ## How it looks
-![](https://github.com/tscholze/kotlin-kotlog-cli/blob/main/docs/kotlog-markdown2html.png?raw=true)
+![Flow](https://github.com/tscholze/kotlin-kotlog-cli/blob/main/docs/kotlog-markdown2html.png?raw=true)
 (Design, look and feel and other ui elements my differ from version to version)
 
 ## Features

__output/2022-09-16-hi-i-m-kotlog-.html

@@ -1,18 +1,26 @@
 import org.jetbrains.kotlin.gradle.tasks.KotlinCompile
 
+// MARK: - Properties -
+
+group = "io.github.tscholze"
+version = "1.0.5"
+
+// MARK: - Plugins -
+
 plugins {
     kotlin("jvm") version "1.7.10"
     kotlin("plugin.serialization") version "1.7.10"
     application
 }
 
-group = "io.github.tscholze"
-version = "1.0.5"
+// MARK: - Repositories -
 
 repositories {
     mavenCentral()
 }
 
+// MARK: - Dependencies -
+
 dependencies {
     // Markdown
     implementation("org.commonmark:commonmark:0.19.0")
@@ -34,6 +42,14 @@ dependencies {
     testImplementation(kotlin("test"))
 }
 
+// MARK: - Application settings -
+
+application {
+    mainClass.set("MainKt")
+}
+
+// MARK: - Gradle tasks -
+
 tasks.jar {
     manifest {
         attributes["Main-Class"] = "MainKt"
@@ -50,8 +66,4 @@ tasks.test {
 
 tasks.withType<KotlinCompile> {
     kotlinOptions.jvmTarget = "1.8"
-}
-
-application {
-    mainClass.set("MainKt")
 }

__output/index.html

@@ -1,17 +1,20 @@
 import io.github.tscholze.kotlog.Kotlog
-import io.github.tscholze.kotlog.models.BlogConfiguration
 
 fun main(args: Array<String>) {
 
-    // 1. Create a configuration for the blog
-    val configuration = BlogConfiguration(
-        baseUrl = "https://tscholze.github.io/blog",
-        titleText = "Tobias Scholze | The Stuttering Nerd",
-        footerText = "Made with ❤️ without JavaScript| Kotlog | Tobias Scholze",
-        outputDirectoryName = "www"
-    )
+    // 1. Create a configuration for the blog,
+    // or it will be fetched from `~/.kotlog file`
+    //
+    // Sample:
+
+    // val configuration = BlogConfiguration(
+    //     baseUrl = "https://tscholze.github.io/blog",
+    //     titleText = "Tobias Scholze | The Stuttering Nerd",
+    //     footerText = "Made with ❤️ without JavaScript| Kotlog | Tobias Scholze",
+    //     outputDirectoryName = "www"
+    //)
 
     // 2. Call and run Kotlog with command line arguments and configuration.
-    Kotlog(args, configuration)
+    Kotlog(args)
 }