Added links into appendix

info/buildSrc/src/main/kotlin/org/cqfn/diktat/generation/docs/GenerationAvailableRules.kt

@@ -43,7 +43,9 @@ data class RuleDescription(val ruleName: String,
     /**
      * Remove square brackets from code style
      */
-    val correctCodeStyle = codeStyle.substring(codeStyle.indexOf("[") + 1, codeStyle.indexOf("]"))
+    val correctCodeStyle = codeStyle.substring(codeStyle.indexOf("[") + 1, codeStyle.indexOf("]")).run {
+        "\\hyperref[sec:$this]{$this}"
+    }
 
     /**
      * Replace space between words with underline for Latex

info/buildSrc/src/main/kotlin/org/cqfn/diktat/generation/docs/GenerationDocs.kt

@@ -80,6 +80,8 @@ fun generateCodeStyle(guideDir: File, wpDir: File) {
                     2 -> writer.writeln("""\subsubsection*{\textbf{$name}}${"\n"}\leavevmode\newline""")
                     else -> {}
                 }
+                writer.writeln("\\label{sec:${name.getFirstNumber()}}")
+
                 continue
             }
             if (iterator.hasNext() && line.trim().startsWith("```")) {
@@ -150,7 +152,7 @@ fun generateCodeStyle(guideDir: File, wpDir: File) {
 
 private fun writeTableContentLine(writer: PrintWriter, line: String, numbOfSpaces: Double) {
     writer.write("\\hspace{${numbOfSpaces}cm}")
-    writer.writeln(line
+    val correctLine = line
             .trim()
             .replace("[", "")
             .replace("]", "")
@@ -159,7 +161,7 @@ private fun writeTableContentLine(writer: PrintWriter, line: String, numbOfSpace
             .replace("_", "\\_")
             .replace("#", "\\#")
             .replace("&", "\\&")
-    )
+    writer.writeln("\\hyperref[sec:${correctLine.getFirstNumber()}]{$correctLine}")
 }
 
 /**
@@ -220,3 +222,5 @@ private fun findBoldOrItalicText(regex: Regex,
     }
     return correctedLine
 }
+
+private fun String.getFirstNumber() = trimStart().takeWhile { it.isDigit() || it == '.' }

info/buildSrc/src/main/kotlin/org/cqfn/diktat/generation/docs/LatexUtils.kt

@@ -9,7 +9,7 @@ import java.io.PrintWriter
 @Suppress("VARIABLE_NAME_INCORRECT_FORMAT")
 val NUMBER_IN_TAG = Regex("\"([a-z0-9.]*)\"")  // finds "r1.0.2"
 @Suppress("VARIABLE_NAME_INCORRECT_FORMAT")
-val RULE_NAME = Regex("(</a>[A-Za-z 0-9.-]*)")  // get's rule name from ### <a>...</a> Rule name
+val RULE_NAME = Regex("(</a>[A-Za-z 0-9'.-]*)")  // get's rule name from ### <a>...</a> Rule name
 @Suppress("VARIABLE_NAME_INCORRECT_FORMAT")
 val BOLD_TEXT = Regex("""\*\*([^*]+)\*\*""")  // finds bold text in regular lines
 @Suppress("VARIABLE_NAME_INCORRECT_FORMAT")

info/guide/diktat-coding-convention.md

@@ -1731,7 +1731,7 @@ val myVariable = emptyMap<Int, String>()
 val myVariable: Map<Int, String> = emptyMap() 
 ```
 
-#### <a name="r4.3.3"></a> Null-safety
+#### <a name="r4.3.3"></a> 4.3.3 Null-safety
 
 Try to avoid explicit null checks (explicit comparison with `null`) 
 Kotlin is declared as [Null-safe](https://kotlinlang.org/docs/reference/null-safety.html) language.
@@ -1864,7 +1864,7 @@ Each nesting level will increase the amount of effort needed to read the code be
 Functional decomposition should be implemented to avoid confusion for the developer who reads the code.
 This will help the reader switch between contexts.
 
-#### <a name="r5.1.3"></a> Rule 5.1.3 Avoid using nested functions
+#### <a name="r5.1.3"></a> 5.1.3 Avoid using nested functions
 Nested functions create a more complex function context, thereby confusing readers.
 With nested functions, the visibility context may not be evident to the code reader.
 

info/guide/guide-chapter-4.md

@@ -199,7 +199,7 @@ val myVariable = emptyMap<Int, String>()
 val myVariable: Map<Int, String> = emptyMap() 
 ```
 
-#### <a name="r4.3.3"></a> Null-safety
+#### <a name="r4.3.3"></a> 4.3.3 Null-safety
 
 Try to avoid explicit null checks (explicit comparison with `null`) 
 Kotlin is declared as [Null-safe](https://kotlinlang.org/docs/reference/null-safety.html) language.

info/guide/guide-chapter-5.md

@@ -46,7 +46,7 @@ Each nesting level will increase the amount of effort needed to read the code be
 Functional decomposition should be implemented to avoid confusion for the developer who reads the code.
 This will help the reader switch between contexts.
 
-#### <a name="r5.1.3"></a> Rule 5.1.3 Avoid using nested functions
+#### <a name="r5.1.3"></a> 5.1.3 Avoid using nested functions
 Nested functions create a more complex function context, thereby confusing readers.
 With nested functions, the visibility context may not be evident to the code reader.