Almirah 0.1.1 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4194e03230075235a57516fed73b44215dde4a7cb42474b641bdbd7ce8a6ad55
-  data.tar.gz: f1a4f05ca5b4cf643cd179019c67cb08ea69c8876a235dfa368e99ec782ab21f
+  metadata.gz: d7a10581e498b38097f10868900c903c9e3bad04bfb3e1d63170bada3222c65b
+  data.tar.gz: 70ac0c4e2893e69ae0aa6c146c4c7a1da2b4ddd7ae0249604bc0b9afcb4980dd
 SHA512:
-  metadata.gz: 56dc9e44de93dccbaf9424d6b654c00e08591b9cdcd62b5061d3356441b68f3c5b6a61778cc9d78bcf277fceb8c25d1b6f9bf34ca6f1a0a0f0284ce361d346a2
-  data.tar.gz: 59790d27191f78845e8b7ca8e19f0c26858234dbb419f248de5034a1aac3451ed9afbcc26905fa062c2efc13b0613f3a60e2b9e57b590c3f6cd01ff55df83809
+  metadata.gz: 9d2f2cfe15dd20b56c31cab7748304007497cbb4a03928df501b2628a261861003a8a0d576ff084ebd54128b03a5c521e6e1da94e8125f93e1233bee94a06ddc
+  data.tar.gz: ff4cbc8d03219cb9792a854dfabbe0b968a097b73e57fca89f0a027bcca11916c646dbca4e64539ea3ac3f6a0b6213d18b71e4e9e323e57a05d83240289bf057

data/lib/almirah/doc_fabric.rb

@@ -8,11 +8,14 @@ require_relative "doc_items/doc_item"
 require_relative "doc_items/heading"
 require_relative "doc_items/paragraph"
 require_relative "doc_items/blockquote"
+require_relative "doc_items/code_block"
+require_relative "doc_items/todo_block"
 require_relative "doc_items/controlled_paragraph"
 require_relative "doc_items/markdown_table"
 require_relative "doc_items/controlled_table"
 require_relative "doc_items/image"
 require_relative "doc_items/markdown_list"
+require_relative "doc_items/doc_footer"
 
 class DocFabric
 
@@ -38,6 +41,7 @@ class DocFabric
 
         tempMdTable = nil
         tempMdList = nil
+        tempCodeBlock = nil
 
         file = File.open( doc.path )
         file_lines = file.readlines     
@@ -58,25 +62,32 @@ class DocFabric
 
                     level = res[1].length
                     value = res[2]
+
+                    if level == 1 && doc.title == ""
+                        doc.title = value
+                        Heading.reset_global_section_number()
+                    end 
+
                     item = Heading.new(value, level)
                     item.parent_doc = doc
                     doc.items.append(item)
                     doc.headings.append(item)
-
-                    if level == 1 && doc.title == ""
-                        doc.title = value
-                    end   
+  
                 elsif res = /^\%\s(.*)/.match(s)     # Pandoc Document Title
 
                     title = res[1]
+
+                    if doc.title == ""
+                        doc.title = title
+                        Heading.reset_global_section_number()
+                    end 
+
                     item = Heading.new(title, 1)
                     item.parent_doc = doc
                     doc.items.append(item)
                     doc.headings.append(item)
 
-                    if doc.title == ""
-                        doc.title = title
-                    end 
+                    Heading.reset_global_section_number()   # Pandoc Document Title is not a section, so it shall not be taken into account in numbering
                     
                 elsif res = /^\[(\S*)\]\s+(.*)/.match(s)     # Controlled Paragraph
 
@@ -91,35 +102,70 @@ class DocFabric
 
                     id = res[1]
                     text = res[2]
+                    up_links = nil
+
+                    #check if it contains the uplink (one or many)
+                    #TODO: check this regular expression
+                    first_pos = text.length # for trailing commas
+                    tmp =  text.scan( /(>\[(?>[^\[\]]|\g<0>)*\])/ )           # >[SRS-001], >[SYS-002]
+                    if tmp.length >0
+                        up_links = Array.new
+                        tmp.each do |ul|
+                            up_links.append(ul[0])
+                            # try to find the real end of text
+                            pos = text.index(ul[0])
+                            if pos < first_pos
+                                first_pos = pos
+                            end
+                            # remove uplink from text
+                            text = text.split(ul[0]).join("")
+                        end
+                        # remove trailing commas and spaces
+                        if text.length > first_pos
+                            first_pos -= 1
+                            text = text[0..first_pos].strip
+                        end
+                    end
 
-                    #check if it contains the uplink
-                    if tmp = /(.*)\s+>\[(\S*)\]$/.match(text)           # >[SRS-001]
+                    # since we already know id and text 
+                    item = ControlledParagraph.new( text, id )
 
-                        text = tmp[1]
-                        up_link = tmp[2]
-                        
-                        if tmp = /^([a-zA-Z]+)[-]\d+/.match(up_link)    # SRS
-                            doc.up_link_doc_id[ tmp[1].downcase.to_s ] = tmp[1].downcase       # multiple documents could be up-linked                            
+                    if up_links
+                        doc.items_with_uplinks_number += 1     #for statistics
+                        up_links.each do |ul|
+                            if tmp = />\[(\S*)\]$/.match(ul)                    # >[SRS-001]
+                                up_link_id = tmp[1]
+
+                                unless item.up_link_ids
+                                    item.up_link_ids = Array.new
+                                end
+
+                                item.up_link_ids.append(up_link_id)      
+                                    
+                                if tmp = /^([a-zA-Z]+)[-]\d+/.match(up_link_id) # SRS
+                                    doc.up_link_doc_id[ tmp[1].downcase.to_s ] = tmp[1].downcase       # multiple documents could be up-linked                            
+                                end
+                            end
                         end
                     end
 
-                    item = ControlledParagraph.new( text, id )
+                    
                     item.parent_doc = doc
                     item.parent_heading = doc.headings[-1]
-                    if up_link
-                         item.up_link = up_link
-                         doc.items_with_uplinks_number += 1     #for statistics
-                    end
 
                     doc.items.append(item)
-                    doc.dictionary[ id.to_s ] = item       #for fast search
+                    #for statistics
+                    if doc.dictionary.has_key?( id.to_s )
+                        doc.duplicated_ids_number += 1
+                        doc.duplicates_list.append(item)
+                    else
+                        doc.dictionary[ id.to_s ] = item       #for fast search
+                    end
                     doc.controlled_items.append(item)      #for fast search
 
                     #for statistics
                     n = /\d+/.match(id)[0].to_i
-                    if n == doc.last_used_id_number
-                        doc.duplicated_ids_number += 1
-                    elsif n > doc.last_used_id_number
+                    if n > doc.last_used_id_number
                         doc.last_used_id = id
                         doc.last_used_id_number = n
                     end
@@ -143,7 +189,7 @@ class DocFabric
 
                     doc.items.append(item)
 
-                elsif res = /^(\*\s?)(.*)/.match(s)   #check if unordered list start
+                elsif res = /^(\*\s+)(.*)/.match(s)   #check if unordered list start
                     
                     if tempMdTable
                         doc.items.append tempMdTable
@@ -230,6 +276,50 @@ class DocFabric
                     item.parent_doc = doc
                     doc.items.append(item)
 
+                elsif res = /^```(\w*)/.match(s)   #check if code block
+
+                    if tempMdTable
+                        doc.items.append tempMdTable
+                        tempMdTable = nil
+                    end
+                    if tempMdList
+                        doc.items.append tempMdList
+                        tempMdList = nil
+                    end 
+
+                    suggested_format = ""
+                    if res.length == 2
+                        suggested_format = res[1]
+                    end
+
+                    if tempCodeBlock
+                        # close already opened block
+                        doc.items.append(tempCodeBlock)
+                        tempCodeBlock = nil
+                    else
+                        #start code block
+                        tempCodeBlock = CodeBlock.new(suggested_format)
+                        tempCodeBlock.parent_doc = doc
+                    end
+                
+                elsif res = /^TODO\:(.*)/.match(s)   #check if TODO block
+
+                    if tempMdTable
+                        doc.items.append tempMdTable
+                        tempMdTable = nil
+                    end
+                    if tempMdList
+                        doc.items.append tempMdList
+                        tempMdList = nil
+                    end 
+
+                    text = "**TODO**: " + res[1]
+
+                    item = TodoBlock.new(text)
+                    item.parent_doc = doc
+                    doc.items.append(item)
+                    doc.todo_blocks.append(item)
+
                 else # Reqular Paragraph
                     if tempMdTable
                         doc.items.append tempMdTable
@@ -244,10 +334,13 @@ class DocFabric
                             tempMdList = nil
                         end
                     end
-
-                    item = Paragraph.new(s)
-                    item.parent_doc = doc
-                    doc.items.append(item)
+                    if tempCodeBlock
+                        tempCodeBlock.code_lines.append(s)
+                    else
+                        item = Paragraph.new(s)
+                        item.parent_doc = doc
+                        doc.items.append(item)
+                    end
                 end
             else
                 if tempMdList   # lists are separated by emty line from each other
@@ -265,5 +358,13 @@ class DocFabric
             doc.items.append tempMdList
             tempMdList = nil
         end
+        if tempCodeBlock
+            doc.items.append tempCodeBlock
+            tempCodeBlock = nil
+        end
+        # Add footer to close opened tables if any
+        item = DocFooter.new
+        item.parent_doc = doc
+        doc.items.append(item)
     end
 end

data/lib/almirah/doc_items/code_block.rb

@@ -0,0 +1,27 @@
+require_relative "doc_item"
+
+class CodeBlock < DocItem
+
+    attr_accessor :suggested_format
+    attr_accessor :code_lines
+
+    def initialize(suggested_format)
+        @suggested_format = suggested_format
+        @code_lines = Array.new
+    end
+
+    def to_html
+        s = ''
+
+        if @@htmlTableRenderInProgress
+            s += "</table>\n"
+            @@htmlTableRenderInProgress = false
+        end
+        s += "<code>"
+        @code_lines.each do |l|
+            s += l + " </br>"
+        end
+        s += "</code>\n"
+        return s
+    end
+end

data/lib/almirah/doc_items/controlled_paragraph.rb

@@ -3,14 +3,14 @@ require_relative "paragraph"
 class ControlledParagraph < Paragraph
 
     attr_accessor :id
-    attr_accessor :up_link
+    attr_accessor :up_link_ids
     attr_accessor :down_links
     attr_accessor :coverage_links
 
     def initialize(text, id)
         @text = text.strip
         @id = id
-        @up_link = nil
+        @up_link_ids = nil
         @down_links = nil
         @coverage_links = nil
     end
@@ -27,11 +27,27 @@ class ControlledParagraph < Paragraph
         s += "\t\t<td class=\"item_id\"> <a name=\"#{@id}\" id=\"#{@id}\" href=\"##{@id}\">#{@id}</a></td>\n"
         s += "\t\t<td class=\"item_text\">#{f_text}</td>\n"
 
-        if @up_link
-            if tmp = /^([a-zA-Z]+)[-]\d+/.match(@up_link)
-                up_link_doc_name = tmp[1].downcase
+        if @up_link_ids
+            if @up_link_ids.length == 1
+                if tmp = /^([a-zA-Z]+)[-]\d+/.match(@up_link_ids[0])
+                    up_link_doc_name = tmp[1].downcase
+                end
+                s += "\t\t<td class=\"item_id\"><a href=\"./../#{up_link_doc_name}/#{up_link_doc_name}.html##{@up_link_ids[0]}\" class=\"external\">#{@up_link_ids[0]}</a></td>\n"
+            else
+                s += "\t\t<td class=\"item_id\">"
+                s += "<div id=\"DL_#{@id}\" style=\"display: block;\">"
+                s += "<a  href=\"#\" onclick=\"downlink_OnClick(this.parentElement); return false;\" class=\"external\">#{@up_link_ids.length}</a>"
+                s += "</div>"
+                s += "<div id=\"DLS_#{@id}\" style=\"display: none;\">"
+                @up_link_ids.each do |lnk|
+                    if tmp = /^([a-zA-Z]+)[-]\d+/.match(lnk)
+                        up_link_doc_name = tmp[1].downcase
+                    end
+                    s += "\t\t\t<a href=\"./../#{up_link_doc_name}/#{up_link_doc_name}.html##{lnk}\" class=\"external\">#{lnk}</a>\n<br>"
+                end
+                s += "</div>"
+                s += "</td>\n"
             end
-            s += "\t\t<td class=\"item_id\"><a href=\"./../#{up_link_doc_name}/#{up_link_doc_name}.html##{@up_link}\" class=\"external\">#{@up_link}</a></td>\n"
         else
             s += "\t\t<td class=\"item_id\"></td>\n"
         end

data/lib/almirah/doc_items/doc_footer.rb

@@ -0,0 +1,17 @@
+require_relative "doc_item"
+
+class DocFooter < DocItem
+
+    def initialize
+    end
+
+    def to_html
+        s = ''
+        if @@htmlTableRenderInProgress
+            s += "</table>\n"
+            @@htmlTableRenderInProgress = false
+        end
+        return s
+    end
+
+end

data/lib/almirah/doc_items/heading.rb

@@ -13,7 +13,7 @@ class Heading < Paragraph
         @level = level
         @anchor_id = getTextWithoutSpaces()
 
-        if @@global_section_number = ""
+        if @@global_section_number == ""
             @@global_section_number = "1"
             for n in 1..(level-1) do
                 @@global_section_number += ".1"
@@ -27,16 +27,21 @@ class Heading < Paragraph
                 a[-1] = (a[-1].to_i() +1).to_s
                 @@global_section_number = a.join(".")
 
-            elsif previous_level < level
+            elsif level > previous_level
 
                 a = @@global_section_number.split(".")
                 a.push("1")
                 @@global_section_number = a.join(".")
             
-            else # previous_level > level
+            else # level < previous_level
 
                 a = @@global_section_number.split(".")
-                a.pop
+                delta = previous_level - level
+                a.pop(delta)
+                @@global_section_number = a.join(".")
+                # increment
+                a = @@global_section_number.split(".")
+                a[-1] = (a[-1].to_i() +1).to_s
                 @@global_section_number = a.join(".")
             end
         end
@@ -59,4 +64,8 @@ class Heading < Paragraph
         s += "&para;</a></h#{headingLevel}>"
         return s
     end
+
+    def self.reset_global_section_number
+        @@global_section_number = ""
+    end
 end

data/lib/almirah/doc_items/image.rb

@@ -21,7 +21,8 @@ class Image < DocItem
             @@htmlTableRenderInProgress = false
         end
 
-        s += "<p style=\"margin-top: 15px;\"><img src=\"#{@path}\" alt=\"#{@text}\">"
+        s += "<p style=\"margin-top: 15px;\"><img src=\"#{@path}\" alt=\"#{@text}\" "
+        s += "href=\"javascript:void(0)\" onclick=\"image_OnClick(this)\">"
         return s
     end
 end

data/lib/almirah/doc_items/markdown_list.rb

@@ -47,7 +47,9 @@ class MarkdownList < DocItem
 
         elsif pos < @@lists_stack[-1].indent_position
 
-            @@lists_stack.pop
+            while pos < @@lists_stack[-1].indent_position
+                @@lists_stack.pop
+            end
             @@lists_stack[-1].rows.append(row)
 
         else
@@ -70,14 +72,27 @@ class MarkdownList < DocItem
     def calculate_text_position(s)
         s.downcase
         pos = 0
-        space_detected = false
+        state = 'looking_for_list_item_marker'
         s.each_char do |c|
-            if space_detected
-                if c != ' ' && c != '\t' && c != '*' && c != '.' && !numeric?(c)
+            if state == 'looking_for_list_item_marker'
+                if c == '*'
+                    state = 'looking_for_space'
+                elsif numeric?(c)
+                    state = 'looking_for_dot'
+                end
+            elsif state == 'looking_for_dot'
+                if c == '.'
+                    state = 'looking_for_space'
+                end
+            elsif state == 'looking_for_space'
+                if c == ' ' || c == '\t'
+                    state = 'looking_for_non_space'
+                end
+            elsif state == 'looking_for_non_space'
+                if c != ' ' || c != '\t'
+                    state = 'list_item_text_pos_found'
                     break
                 end
-            elsif c == ' ' || c == '\t'
-                space_detected = true
             end
             pos += 1
         end

data/lib/almirah/doc_items/text_line.rb

@@ -155,7 +155,7 @@ class TextLine
     def link(link_text, link_url)
 
         # define default result first
-        result = "<a href=\"#{link_url}\" class=\"external\">#{link_text}</a>"
+        result = "<a target=\"_blank\" rel=\"noopener\" href=\"#{link_url}\" class=\"external\">#{link_text}</a>"
 
         lazy_doc_id, anchor = nil, nil
 

data/lib/almirah/doc_items/todo_block.rb

@@ -0,0 +1,22 @@
+require_relative "doc_item"
+
+class TodoBlock < DocItem
+
+    attr_accessor :text
+
+    def initialize(text)
+        @text = text
+    end
+
+    def to_html
+        s = ''
+        f_text = format_string(@text)
+        if @@htmlTableRenderInProgress
+            s += "</table>\n"
+            @@htmlTableRenderInProgress = false
+        end
+
+        s += "<div class=\"todoblock\"><p>#{f_text}</div>\n"
+        return s
+    end
+end

data/lib/almirah/doc_types/index.rb

@@ -34,6 +34,8 @@ class Index < BaseDocument
         s += "\t\t<th>Items<br>w/ Downlinks</th>\n"
         s += "\t\t<th>Covered<br>by Tests</th>\n"
         s += "\t\t<th>Duplicated<br>ids</th>\n"
+        s += "\t\t<th>Wrong<br>links</th>\n"
+        s += "\t\t<th>TODOs</th>\n"
         s += "\t\t<th>Last Used<br>id</th>\n"
         s += "</thead>\n"
         html_rows.append s
@@ -47,7 +49,43 @@ class Index < BaseDocument
             s += "\t\t<td class=\"item_id\" style='width: 7%;'>#{doc.items_with_uplinks_number.to_s}</td>\n"
             s += "\t\t<td class=\"item_id\" style='width: 7%;'>#{doc.items_with_downlinks_number.to_s}</td>\n"
             s += "\t\t<td class=\"item_id\" style='width: 7%;'>#{doc.items_with_coverage_number.to_s}</td>\n"
-            s += "\t\t<td class=\"item_id\" style='width: 7%;'>#{doc.duplicated_ids_number.to_s}</td>\n"
+            
+            if doc.duplicated_ids_number >0
+                s += "\t\t<td class=\"item_id\" style='width: 7%; background-color: #fcc;'>"
+                s += "<div id=\"DL_#{doc.id}\" style=\"display: block;\">"
+                s += "<a  href=\"#\" onclick=\"downlink_OnClick(this.parentElement); return false;\" class=\"external\">#{doc.duplicated_ids_number.to_s}</a>"
+                s += "</div>"
+                s += "<div id=\"DLS_#{doc.id}\" style=\"display: none;\">"
+                doc.duplicates_list.each do |lnk|
+                    s += "\t\t\t<a href=\"./specifications/#{doc.id}/#{doc.id}.html##{lnk.id}\" class=\"external\">#{lnk.id}</a>\n<br>"
+                end
+                s += "</div>"
+                s += "</td>\n"
+            else
+                s += "\t\t<td class=\"item_id\" style='width: 7%;'>#{doc.duplicated_ids_number.to_s}</td>\n"
+            end
+
+            if doc.wrong_links_hash.length >0
+                s += "\t\t<td class=\"item_id\" style='width: 7%; background-color: #fcc;'>"
+                s += "<div id=\"DL_#{doc.id}wl\" style=\"display: block;\">"
+                s += "<a  href=\"#\" onclick=\"downlink_OnClick(this.parentElement); return false;\" class=\"external\">#{doc.wrong_links_hash.length.to_s}</a>"
+                s += "</div>"
+                s += "<div id=\"DLS_#{doc.id}wl\" style=\"display: none;\">"
+                doc.wrong_links_hash.each do |wrong_lnk, item|
+                    s += "\t\t\t<a href=\"./specifications/#{doc.id}/#{doc.id}.html##{item.id}\" class=\"external\">#{wrong_lnk}</a>\n<br>"
+                end
+                s += "</div>"
+                s += "</td>\n"
+            else
+                s += "\t\t<td class=\"item_id\" style='width: 7%;'>#{doc.wrong_links_hash.length.to_s}</td>\n"
+            end
+
+            if doc.todo_blocks.length >0
+                color = "background-color: #fcc;"
+            else
+                color = ""
+            end
+            s += "\t\t<td class=\"item_id\" style='width: 7%; #{color}'>#{doc.todo_blocks.length.to_s}</td>\n"
             s += "\t\t<td class=\"item_id\" style='width: 7%;'>#{doc.last_used_id.to_s}</td>\n"
             s += "</tr>\n"
             html_rows.append s

data/lib/almirah/doc_types/specification.rb

@@ -5,11 +5,14 @@ class Specification < BaseDocument
     attr_accessor :up_link_doc_id
     attr_accessor :dictionary
     attr_accessor :controlled_items
+    attr_accessor :todo_blocks
+    attr_accessor :wrong_links_hash
 
     attr_accessor :items_with_uplinks_number
     attr_accessor :items_with_downlinks_number
     attr_accessor :items_with_coverage_number
     attr_accessor :duplicated_ids_number
+    attr_accessor :duplicates_list
     attr_accessor :last_used_id
     attr_accessor :last_used_id_number
 
@@ -21,6 +24,9 @@ class Specification < BaseDocument
         @headings = Array.new
         @controlled_items = Array.new
         @dictionary = Hash.new
+        @duplicates_list = Array.new
+        @todo_blocks = Array.new
+        @wrong_links_hash = Hash.new
 
         @items_with_uplinks_number = 0
         @items_with_downlinks_number = 0

data/lib/almirah/project.rb

@@ -35,6 +35,7 @@ class Project
         parse_all_protocols
         link_all_specifications
         link_all_protocols
+        check_wrong_specification_referenced
         create_index
         render_all_specifications(@specifications)
         render_all_specifications(@traceability_matrices)
@@ -49,6 +50,7 @@ class Project
         parse_test_run test_run
         link_all_specifications
         link_all_protocols
+        check_wrong_specification_referenced
         create_index
         render_all_specifications(@specifications)
         render_all_specifications(@traceability_matrices)
@@ -123,6 +125,37 @@ class Project
         end
     end
 
+    def check_wrong_specification_referenced
+
+        available_specification_ids = Hash.new
+
+        @specifications.each do |s|
+            available_specification_ids[ s.id.to_s.downcase ] = s
+        end
+
+        @specifications.each do |s|
+            s.up_link_doc_id.each do |key, value|
+                unless available_specification_ids.has_key?(key)
+                    # now key points to the doc_id that does not exist
+                    wrong_doc_id = key
+                    # find the item that reference to it
+                    s.controlled_items.each do |item|
+                        unless item.up_link_ids.nil?
+                            item.up_link_ids.each do |up_link_id|
+                                if tmp = /^([a-zA-Z]+)[-]\d+/.match(up_link_id) # SRS
+                                    if tmp[1].downcase == wrong_doc_id
+                                        # we got it finally!
+                                        s.wrong_links_hash[ up_link_id.to_s ] = item
+                                    end
+                                end
+                            end
+                        end
+                    end
+                end
+            end
+        end
+    end
+
     def link_two_specifications(doc_A, doc_B)
 
         if doc_B.up_link_doc_id.has_key?(doc_A.id.to_s)
@@ -137,15 +170,27 @@ class Project
         #puts "Link: #{doc_A.id} - #{doc_B.id}" 
         bottom_document.controlled_items.each do |item|
 
-            if top_document.dictionary.has_key?(item.up_link.to_s)
-
-                topItem = top_document.dictionary[item.up_link.to_s]
-                
-                unless topItem.down_links
-                    topItem.down_links = Array.new
-                    top_document.items_with_downlinks_number += 1   # for statistics
+            if item.up_link_ids
+                item.up_link_ids.each do |up_lnk|
+
+                    if top_document.dictionary.has_key?(up_lnk.to_s)
+
+                        topItem = top_document.dictionary[up_lnk.to_s]
+                        
+                        unless topItem.down_links
+                            topItem.down_links = Array.new
+                            top_document.items_with_downlinks_number += 1   # for statistics
+                        end
+                        topItem.down_links.append(item)
+                    else
+                        # check if there is a non existing link with the right doc_id
+                        if tmp = /^([a-zA-Z]+)[-]\d+/.match(up_lnk) # SRS
+                            if tmp[1].downcase == top_document.id.downcase
+                                bottom_document.wrong_links_hash[ up_lnk ] = item
+                            end
+                        end
+                    end
                 end
-                topItem.down_links.append(item)
             end
         end
         # create treceability document

data/lib/almirah/templates/page.html

@@ -2,6 +2,7 @@
 <html lang="en">
 <head>
 <meta charset="utf-8" />
+<title>{{DOCUMENT_TITLE}}</title>
 <!-- CSS -->
 <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css">
 <style>
@@ -144,6 +145,34 @@
         margin-top: 4px;
         margin-bottom: 4px;
     }
+    code {
+        display: block;
+        background:#ffffee;
+        border-left: 3px double #bbb;
+        font-family: Consolas, Menlo, "Liberation Mono", Courier, monospace;
+        padding: 4px 1em 4px 4px;
+        margin-top: 4px;
+        margin-bottom: 4px;
+    }
+    div.todoblock {
+        display: block;
+        background:#fcc;
+        border-left: 3px double #bbb;
+        font-style: italic;
+        padding: 4px 1em 4px 4px;
+        margin-top: 4px;
+        margin-bottom: 4px;
+    }
+    img:hover{
+        transition: 0.3s;
+    }
+    img{
+        opacity: 0.9;
+        cursor: pointer;
+    }
+    #modal_image_id{
+        cursor: default;
+    } 
     #nav_pane{
         flex-shrink: 0;
         padding: 16px 8px 2px 8px;
@@ -164,6 +193,7 @@
         overflow: hidden;
         position: fixed;
         width: 100%;    
+        z-index: 1;
     }
     #top_nav a {
         float: left;
@@ -191,7 +221,67 @@
         background-color: #169;
         color: white;
     }
-
+    .modal {
+        display: none; /* Hidden by default */
+        position: fixed; /* Stay in place */
+        z-index: 1; /* Sit on top */
+        padding-top: 100px; /* Location of the box */
+        left: 0;
+        top: 0;
+        width: 100%; /* Full width */
+        height: 100%; /* Full height */
+        overflow: auto; /* Enable scroll if needed */
+        background-color: rgb(0,0,0); /* Fallback color */
+        background-color: rgba(0,0,0,0.9); /* Black w/ opacity */
+    }
+    .modal_image {
+        margin: auto;
+        display: block;
+        width: 97%;
+        /*max-width: 700px;*/
+    }
+    #modal_image_caption {
+        margin: auto;
+        display: block;
+        width: 80%;
+        max-width: 700px;
+        text-align: center;
+        color: #ccc;
+        padding: 10px 0;
+        height: 150px;
+    }
+    .modal_image, #modal_image_caption {  
+        animation-name: zoom;
+        animation-duration: 0.6s;
+    }
+    @keyframes zoom {
+        from {transform: scale(0.1)} 
+        to {transform: scale(1)}
+    }
+    .modal_close_btn {
+        position: absolute;
+        top: 15px;
+        right: 35px;
+        color: #f1f1f1;
+        font-size: 30px;
+        font-weight: bold;
+        transition: 0.3s;
+    }
+    .modal_close_btn:hover,
+    .modal_close_btn:focus {
+        color: #bbb;
+        text-decoration: none;
+        cursor: pointer;
+    }
+    #footer {
+        clear: both;
+        border-top: 1px solid #bbb;
+        font-size: 0.9em;
+        color: #aaa;
+        padding: 5px;
+        text-align:center;
+        background:#fff;
+    }
 </style>
 <script>
 function openNav() {
@@ -221,11 +311,36 @@ function downlink_OnClick(clicked){
     required_id = "DLS_" + id_parts[1];
     document.getElementById(required_id).style.display = 'block';
 }
+
+function navigate_to_home(){
+    if (document.title != "Document Index")
+    {
+        window.location.href = "./../../index.html";
+    }
+}
+
+// Modal window for image zoom
+function image_OnClick(clicked){
+
+    var modal = document.getElementById('image_modal_div');
+    var modalImg = document.getElementById("modal_image_id");
+    var captionText = document.getElementById("modal_image_caption");
+
+    modal.style.display = "block";
+    modalImg.src = clicked.src;
+    captionText.innerHTML = clicked.alt;
+}
+
+function modal_close_OnClick(clicked){
+    var modal = document.getElementById('image_modal_div');
+    modal.style.display = "none";
+}
+
 </script>
 </head>
 <body>
     <div id="top_nav">
-        <a href="./../../index.html"><span><i class="fa fa-home" aria-hidden="true"></i></span>&nbsp;Home</a>
+        <a href="javascript:void(0)" onclick="navigate_to_home()"><span><i class="fa fa-home" aria-hidden="true"></i></span>&nbsp;Home</a>
         <!--a href="javascript:void(0)"> About</a-->
         <a class="split">{{DOCUMENT_TITLE}}</a>
     </div>
@@ -235,7 +350,16 @@ function downlink_OnClick(clicked){
         </div>
         <div id="content" href="javascript:void(0)" onclick="closeNav()">
             {{CONTENT}}
-        </div>
+        </div><!-- content -->
+    </div><!-- main -->
+    <div id="footer">
+        Powered by <a target="_blank" rel="noopener" href="https://www.almirah.site/">Almirah Framework</a>
+    </div><!-- footer -->
+    <!-- The modal window for image zoom -->
+    <div id="image_modal_div" class="modal">
+        <span class="modal_close_btn" href="javascript:void(0)" onclick="modal_close_OnClick(this)">&times;</span>
+        <img class="modal_image" id="modal_image_id">
+        <div id="modal_image_caption"></div>
     </div>
 </body>
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: Almirah
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.4
 platform: ruby
 authors:
 - Oleksandr Ivanov
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-03-13 00:00:00.000000000 Z
+date: 2024-04-18 00:00:00.000000000 Z
 dependencies: []
 description: The software part of the Almirah framework
 email: oleksandr.ivanov.development@gmail.com
@@ -21,9 +21,11 @@ files:
 - lib/almirah.rb
 - lib/almirah/doc_fabric.rb
 - lib/almirah/doc_items/blockquote.rb
+- lib/almirah/doc_items/code_block.rb
 - lib/almirah/doc_items/controlled_paragraph.rb
 - lib/almirah/doc_items/controlled_table.rb
 - lib/almirah/doc_items/controlled_table_row.rb
+- lib/almirah/doc_items/doc_footer.rb
 - lib/almirah/doc_items/doc_item.rb
 - lib/almirah/doc_items/heading.rb
 - lib/almirah/doc_items/image.rb
@@ -31,6 +33,7 @@ files:
 - lib/almirah/doc_items/markdown_table.rb
 - lib/almirah/doc_items/paragraph.rb
 - lib/almirah/doc_items/text_line.rb
+- lib/almirah/doc_items/todo_block.rb
 - lib/almirah/doc_types/base_document.rb
 - lib/almirah/doc_types/coverage.rb
 - lib/almirah/doc_types/index.rb
@@ -59,7 +62,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.6
+rubygems_version: 3.5.9
 signing_key:
 specification_version: 4
 summary: Almirah