Almirah 0.0.9 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9e500204a8575e500989c7d86e4db4dff7a6247b14d3768904620be7a3cef356
-  data.tar.gz: a12d76101a33fc1938c0c42d361f84ae9a8c796684becd1567e154e67f345cad
+  metadata.gz: 4194e03230075235a57516fed73b44215dde4a7cb42474b641bdbd7ce8a6ad55
+  data.tar.gz: f1a4f05ca5b4cf643cd179019c67cb08ea69c8876a235dfa368e99ec782ab21f
 SHA512:
-  metadata.gz: eff42c3d45f0be71488484ce864740c5363e9169450d32469b9044136ea47af2989b32c4cb526c176c4d4721e60be0c5f484db8ed2245285eb042187a9c5df57
-  data.tar.gz: 2e5c4887b584428a71db8cbd33d244242c90df9b7b02aca8804f72f97fb017dfebc4aa8ff2ae52f924ae9895f7ac1b075cac2407ba84888db55cd36d97984344
+  metadata.gz: 56dc9e44de93dccbaf9424d6b654c00e08591b9cdcd62b5061d3356441b68f3c5b6a61778cc9d78bcf277fceb8c25d1b6f9bf34ca6f1a0a0f0284ce361d346a2
+  data.tar.gz: 59790d27191f78845e8b7ca8e19f0c26858234dbb419f248de5034a1aac3451ed9afbcc26905fa062c2efc13b0613f3a60e2b9e57b590c3f6cd01ff55df83809

data/lib/almirah/doc_fabric.rb

@@ -3,6 +3,7 @@ require_relative "doc_types/base_document"
 require_relative "doc_types/specification"
 require_relative "doc_types/protocol"
 #
+require_relative "doc_items/text_line"
 require_relative "doc_items/doc_item"
 require_relative "doc_items/heading"
 require_relative "doc_items/paragraph"
@@ -15,6 +16,12 @@ require_relative "doc_items/markdown_list"
 
 class DocFabric
 
+    def self.add_lazy_doc_id(path)
+        if res = /(\w+)[.]md$/.match(path)
+            TextLine.add_lazy_doc_id(res[1])
+        end
+    end
+
     def self.create_specification(path)
         doc = Specification.new path
         DocFabric.parse_document doc
@@ -59,7 +66,18 @@ class DocFabric
                     if level == 1 && doc.title == ""
                         doc.title = value
                     end   
-                        
+                elsif res = /^\%\s(.*)/.match(s)     # Pandoc Document Title
+
+                    title = res[1]
+                    item = Heading.new(title, 1)
+                    item.parent_doc = doc
+                    doc.items.append(item)
+                    doc.headings.append(item)
+
+                    if doc.title == ""
+                        doc.title = title
+                    end 
+                    
                 elsif res = /^\[(\S*)\]\s+(.*)/.match(s)     # Controlled Paragraph
 
                     if tempMdTable
@@ -81,12 +99,13 @@ class DocFabric
                         up_link = tmp[2]
                         
                         if tmp = /^([a-zA-Z]+)[-]\d+/.match(up_link)    # SRS
-                            doc.up_link_doc_id = tmp[1].downcase
+                            doc.up_link_doc_id[ tmp[1].downcase.to_s ] = tmp[1].downcase       # multiple documents could be up-linked                            
                         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
@@ -134,7 +153,7 @@ class DocFabric
                     row = res[2]
 
                     if tempMdList
-                        tempMdList.addRow(row)
+                        tempMdList.addRow(s)
                     else
                         item = MarkdownList.new(false)
                         item.addRow(s)
@@ -152,7 +171,7 @@ class DocFabric
                     row = res[1]
 
                     if tempMdList
-                        tempMdList.addRow(row)
+                        tempMdList.addRow(s)
                     else
                         item = MarkdownList.new(true)
                         item.addRow(s)

data/lib/almirah/doc_items/controlled_paragraph.rb

@@ -19,7 +19,7 @@ class ControlledParagraph < Paragraph
         s = ''
         unless @@htmlTableRenderInProgress                    
             s += "<table class=\"controlled\">\n"
-            s += "\t<thead> <th>#</th> <th>Text</th> <th>UL</th> <th>DL</th> <th>COV</th> </thead>\n"
+            s += "\t<thead> <th>#</th> <th></th> <th>UL</th> <th>DL</th> <th>COV</th> </thead>\n"
             @@htmlTableRenderInProgress = true
         end
         f_text = format_string(@text)
@@ -40,7 +40,20 @@ class ControlledParagraph < Paragraph
             if tmp = /^([a-zA-Z]+)[-]\d+/.match(@down_links[0].id)    # guessing that all the links refer to one document
                 down_link_doc_name = tmp[1].downcase
             end
-            s += "\t\t<td class=\"item_id\"><a href=\"./../#{down_link_doc_name}/#{down_link_doc_name}.html\" class=\"external\">#{@down_links.length}</a></td>\n"
+            if @down_links.length == 1
+                s += "\t\t<td class=\"item_id\"><a href=\"./../#{down_link_doc_name}/#{down_link_doc_name}.html##{@down_links[0].id}\" class=\"external\">#{@down_links[0].id}</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\">#{@down_links.length}</a>"
+                s += "</div>"
+                s += "<div id=\"DLS_#{@id}\" style=\"display: none;\">"
+                @down_links.each do |lnk|
+                    s += "\t\t\t<a href=\"./../#{lnk.parent_doc.id}/#{lnk.parent_doc.id}.html##{lnk.id}\" class=\"external\">#{lnk.id}</a>\n<br>"
+                end
+                s += "</div>"
+                s += "</td>\n"
+            end
         else
             s += "\t\t<td class=\"item_id\"></td>\n"
         end

data/lib/almirah/doc_items/controlled_table.rb

@@ -128,9 +128,9 @@ class ControlledTable < DocItem
                 new_row.columns.append col
                 # save uplink key but do not rewrite
                 if col.up_link_doc_id != nil 
-                    if @parent_doc.up_link_doc_id == ""
-                        @parent_doc.up_link_doc_id = col.up_link_doc_id
-                    end
+                    
+                    @parent_doc.up_link_doc_id[ col.up_link_doc_id.to_s ] = col.up_link_doc_id
+
                     # save reference to the test step
                     new_row.up_link = col.up_link
                     @parent_doc.controlled_items.append new_row

data/lib/almirah/doc_items/doc_item.rb

@@ -2,8 +2,10 @@ require_relative "text_line"
 
 class DocItem < TextLine
     attr_accessor :parent_doc
+    attr_accessor :parent_heading
     
     @parent_doc = nil
+    @parent_heading = nil
 
     @@htmlTableRenderInProgress = false
 end

data/lib/almirah/doc_items/heading.rb

@@ -4,11 +4,47 @@ class Heading < Paragraph
 
     attr_accessor :level
     attr_accessor :anchor_id
+    attr_accessor :section_number
+
+    @@global_section_number = ""
 
     def initialize(text, level)
         @text = text
         @level = level
         @anchor_id = getTextWithoutSpaces()
+
+        if @@global_section_number = ""
+            @@global_section_number = "1"
+            for n in 1..(level-1) do
+                @@global_section_number += ".1"
+            end
+        else
+            previous_level = @@global_section_number.split(".").length
+
+            if previous_level == level
+
+                a = @@global_section_number.split(".")
+                a[-1] = (a[-1].to_i() +1).to_s
+                @@global_section_number = a.join(".")
+
+            elsif previous_level < level
+
+                a = @@global_section_number.split(".")
+                a.push("1")
+                @@global_section_number = a.join(".")
+            
+            else # previous_level > level
+
+                a = @@global_section_number.split(".")
+                a.pop
+                @@global_section_number = a.join(".")
+            end
+        end
+        @section_number = @@global_section_number
+    end
+
+    def get_section_info
+        s = @section_number + " " + @text
     end
 
     def to_html

data/lib/almirah/doc_items/image.rb

@@ -21,7 +21,7 @@ class Image < DocItem
             @@htmlTableRenderInProgress = false
         end
 
-        s += "<img src=\"#{@path}\" alt=\"#{@text}\">"
+        s += "<p style=\"margin-top: 15px;\"><img src=\"#{@path}\" alt=\"#{@text}\">"
         return s
     end
 end

data/lib/almirah/doc_items/markdown_list.rb

@@ -21,7 +21,6 @@ class MarkdownList < DocItem
     end
 
     def addRow(raw_text)
-        puts raw_text
         pos = calculate_text_position(raw_text)
         row = raw_text[pos..-1]
 
@@ -40,7 +39,7 @@ class MarkdownList < DocItem
                 #cannot be there
             else
                 nested_list.text = prev_row
-                puts "Length: " + prev_lists_stack_item.rows.length.to_s
+                #puts "Length: " + prev_lists_stack_item.rows.length.to_s
                 prev_lists_stack_item.rows[-1] = nested_list
             end
             
@@ -58,9 +57,10 @@ class MarkdownList < DocItem
     end
 
     def calculate_indent_position(s)
+        s.downcase
         pos = 0
         s.each_char do |c|
-            if non_blank?(c)
+            if c != ' ' && c != '\t'
                 break
             end
             pos += 1
@@ -68,10 +68,16 @@ class MarkdownList < DocItem
         return pos
     end
     def calculate_text_position(s)
+        s.downcase
         pos = 0
+        space_detected = false
         s.each_char do |c|
-            if letter?(c)
-                break
+            if space_detected
+                if c != ' ' && c != '\t' && c != '*' && c != '.' && !numeric?(c)
+                    break
+                end
+            elsif c == ' ' || c == '\t'
+                space_detected = true
             end
             pos += 1
         end
@@ -127,6 +133,7 @@ class MarkdownList < DocItem
                 s += "</li>\n"
             else
                 f_text = format_string(r)
+                #puts f_text
                 s += "\t<li>#{f_text}</li>\n"
             end
         end

data/lib/almirah/doc_items/text_line.rb

@@ -1,5 +1,12 @@
 class TextLine
 
+    @@lazy_doc_id_dict = Hash.new
+
+    def self.add_lazy_doc_id(id)
+        doc_id = id.to_s.downcase
+        @@lazy_doc_id_dict[doc_id] = doc_id
+    end
+
     def format_string(str)
         state = 'default'
         prev_state = 'default'
@@ -11,134 +18,111 @@ class TextLine
         str.each_char do |c|
             if c == '*'
                 if state == 'default'
-                    prev_state = state
-                    state = 'first_asterisk_detected'
+                    prev_state, state = change_state(c, state, 'first_asterisk_detected')
 
                 elsif state == 'first_asterisk_detected'
-                    prev_state = state
-                    state = 'second_asterisk_detected'
+                    prev_state, state = change_state(c, state, 'second_asterisk_detected')
                 
                 elsif state == 'second_asterisk_detected'
-                    prev_state = state
-                    state = 'third_asterisk_detected'
+                    prev_state, state = change_state(c, state, 'third_asterisk_detected')
                 
                 elsif state == 'second_asterisk_detected'
-                    prev_state = state
-                    state = 'third_asterisk_detected' 
+                    prev_state, state = change_state(c, state, 'third_asterisk_detected')
 
                 elsif state == 'italic_started'
-                    prev_state = state
-                    state = 'default'
+                    prev_state, state = change_state(c, state, 'default')
                     result += italic(stack)
 
                 elsif state == 'bold_started'
-                    prev_state = state
-                    state = 'first_asterisk_after_bold_detected'
+                    prev_state, state = change_state(c, state, 'first_asterisk_after_bold_detected')
 
                 elsif state == 'first_asterisk_after_bold_detected'
-                    prev_state = state
-                    state = 'default'
+                    prev_state, state = change_state(c, state, 'default')
                     result += bold(stack)
 
                 elsif state == 'bold_and_italic_started'
-                    prev_state = state
-                    state = 'first_asterisk_after_bold_and_italic_detected'
+                    prev_state, state = change_state(c, state, 'first_asterisk_after_bold_and_italic_detected')
 
                 elsif state == 'first_asterisk_after_bold_and_italic_detected'
-                    prev_state = state
-                    state = 'second_asterisk_after_bold_and_italic_detected'
+                    prev_state, state = change_state(c, state, 'second_asterisk_after_bold_and_italic_detected')
 
                 elsif state == 'second_asterisk_after_bold_and_italic_detected'
-                    prev_state = state
-                    state = 'default'
+                    prev_state, state = change_state(c, state, 'default')
                     result += bold_and_italic(stack)
 
                 else
                 end
             elsif c == '['
                 if state == 'default'
-                    prev_state = state
-                    state = 'square_bracket_left_detected'
+                    prev_state, state = change_state(c, state, 'square_bracket_left_detected')
                 else
                 end
             elsif c == ']'
                 if state == 'square_bracket_left_detected'
-                    prev_state = state
-                    state = 'default'
+                    prev_state, state = change_state(c, state, 'default')
                     result += '[]'
 
                 elsif state == 'link_text_started'
-                    prev_state = state
-                    state = 'square_bracket_right_detected'
+                    prev_state, state = change_state(c, state, 'square_bracket_right_detected')
                     link_text = stack
 
                 else
                 end
             elsif c == '('
                 if state == 'square_bracket_right_detected'
-                    prev_state = state
-                    state = 'brace_left_detected'
+                    prev_state, state = change_state(c, state, 'brace_left_detected')
                 else
+                    result += c
                 end
             elsif c == ')'
                 if state == 'brace_left_detected'
-                    prev_state = state
-                    state = 'default'
+                    prev_state, state = change_state(c, state, 'default')
                     result += '()'
 
                 elsif state == 'link_url_started'
-                    prev_state = state
-                    state = 'default'
+                    prev_state, state = change_state(c, state, 'default')
                     link_url = stack
                     result += link(link_text, link_url)
 
                 else
+                    result += c
                 end
             else
                 if state == 'default'
                     result += c
                 else
                     if state == 'first_asterisk_detected'
-                        prev_state = state
-                        state = 'italic_started'
+                        prev_state, state = change_state(c, state, 'italic_started')
                         stack = ''
 
                     elsif state == 'second_asterisk_detected'
-                        prev_state = state
-                        state = 'bold_started'
+                        prev_state, state = change_state(c, state, 'bold_started')
                         stack = ''
 
                     elsif state == 'third_asterisk_detected'
-                        prev_state = state
-                        state = 'bold_and_italic_started'
+                        prev_state, state = change_state(c, state, 'bold_and_italic_started')
                         stack = ''
                     
                     elsif state == 'first_asterisk_after_bold_detected'
-                        prev_state = state
-                        state = 'bold_started'
+                        prev_state, state = change_state(c, state, 'bold_started')
 
                     elsif state == 'first_asterisk_after_bold_and_italic_detected'
-                        prev_state = state
-                        state = 'bold_and_italic_started'
+                        prev_state, state = change_state(c, state, 'bold_and_italic_started')
 
                     elsif state == 'second_asterisk_after_bold_and_italic_detected'
-                        prev_state = state
-                        state = 'bold_and_italic_started'
+                        prev_state, state = change_state(c, state, 'bold_and_italic_started')
 
                     elsif state == 'square_bracket_left_detected'
-                        prev_state = state
-                        state = 'link_text_started'
+                        prev_state, state = change_state(c, state, 'link_text_started')
                         stack = ''
 
                     elsif state == 'square_bracket_right_detected'
-                        prev_state = state
-                        state = 'default'
+                        prev_state, state = change_state(c, state, 'default')
                         result += stack + c
                         c = ''
 
                     elsif state == 'brace_left_detected'
-                        prev_state = state
-                        state = 'link_url_started'
+                        prev_state, state = change_state(c, state, 'link_url_started')
                         stack = ''
 
                     else
@@ -151,6 +135,11 @@ class TextLine
         return result
     end
 
+    def change_state(c, cur_state, new_state)
+        # puts "[#{c}] Transition: #{cur_state} --> #{new_state}"
+        return cur_state, new_state
+    end
+
     def italic(str)
         "<i>#{str}</i>"
     end
@@ -164,6 +153,31 @@ class TextLine
     end
 
     def link(link_text, link_url)
-        "<a href=\"#{link_url}\" class=\"external\">#{link_text}</a>"
+
+        # define default result first
+        result = "<a href=\"#{link_url}\" class=\"external\">#{link_text}</a>"
+
+        lazy_doc_id, anchor = nil, nil
+
+        if res = /(\w+)[.]md$/.match(link_url)          #link
+            lazy_doc_id = res[1].to_s.downcase
+
+        elsif res = /(\w*)[.]md(#.*)$/.match(link_url)  # link with anchor
+            if res && res.length > 2
+                lazy_doc_id = res[1]
+                anchor = res[2]
+            end
+        end
+
+        if lazy_doc_id
+            if @@lazy_doc_id_dict.has_key?(lazy_doc_id)
+                if anchor
+                    result = "<a href=\".\\..\\#{lazy_doc_id}\\#{lazy_doc_id}.html#{anchor}\" class=\"external\">#{link_text}</a>"
+                else
+                    result = "<a href=\".\\..\\#{lazy_doc_id}\\#{lazy_doc_id}.html\" class=\"external\">#{link_text}</a>"
+                end
+            end
+        end
+        return result
     end
 end

data/lib/almirah/doc_types/base_document.rb

@@ -25,7 +25,11 @@ class BaseDocument
         file_data = file.readlines
         file.close
 
-        output_file_path += "#{@id}/#{@id}.html"
+        if @id == 'index'
+            output_file_path += "#{@id}.html"
+        else
+            output_file_path += "#{@id}/#{@id}.html"
+        end
         file = File.open( output_file_path, "w" )
         file_data.each do |s|
             if s.include?('{{CONTENT}}')
@@ -36,6 +40,8 @@ class BaseDocument
                 if nav_pane
                     file.puts nav_pane.to_html
                 end
+            elsif s.include?('{{DOCUMENT_TITLE}}')
+                file.puts s.gsub! '{{DOCUMENT_TITLE}}', @title
             else
                 file.puts s
             end

data/lib/almirah/doc_types/index.rb

@@ -0,0 +1,107 @@
+require_relative "base_document"
+
+class Index < BaseDocument
+
+    attr_accessor :items
+    attr_accessor :project
+
+    def initialize(project)
+        @items = Array.new
+        @project = project
+
+        @title = "Document Index"
+        @id = "index"
+    end
+
+    def to_console
+        puts "\e[36m" + "Index: " + @id + "\e[0m"
+    end
+
+    def to_html(output_file_path)
+
+        html_rows = Array.new
+
+        html_rows.append('')
+        s = "<h1>#{@title}</h1>\n"
+
+        # Specifications
+        s = "<h2>Specifications</h2>\n"
+        s += "<table class=\"controlled\">\n"
+        s += "\t<thead>\n"
+        s += "\t\t<th>Title</th>\n"
+        s += "\t\t<th>Items</th>\n"
+        s += "\t\t<th>Items<br>w/ Uplinks</th>\n"
+        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>Last Used<br>id</th>\n"
+        s += "</thead>\n"
+        html_rows.append s
+
+        sorted_items = @project.specifications.sort_by { |w| w.id }
+
+        sorted_items.each do |doc|
+            s = "\t<tr>\n"
+            s += "\t\t<td class=\"item_text\" style='padding: 5px;'><a href=\"./specifications/#{doc.id}/#{doc.id}.html\" class=\"external\">#{doc.title}</a></td>\n"
+            s += "\t\t<td class=\"item_id\" style='width: 7%;'>#{doc.controlled_items.length.to_s}</td>\n"
+            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"
+            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
+        end
+        html_rows.append "</table>\n"
+
+        # Traceability Matrices
+        s = "<h2>Traceability Matrices</h2>\n"
+        s += "<table class=\"controlled\">\n"
+        s += "\t<thead>\n"
+        s += "\t\t<th>Title</th>\n"
+        s += "\t\t<th>Top Document</th>\n"
+        s += "\t\t<th>Bottom Document</th>\n"
+        s += "</thead>\n"
+        html_rows.append s
+
+        sorted_items = @project.traceability_matrices.sort_by { |w| w.id }
+
+        sorted_items.each do |doc|
+            s = "\t<tr>\n"
+            s += "\t\t<td class=\"item_text\" style='padding: 5px;'><a href=\"./specifications/#{doc.id}/#{doc.id}.html\" class=\"external\">#{doc.title}</a></td>\n"
+            s += "\t\t<td class=\"item_text\" style='width: 25%; padding: 5px;'>#{doc.top_doc.title}</td>\n"
+            s += "\t\t<td class=\"item_text\" style='width: 25%; padding: 5px;'>#{doc.bottom_doc.title}</td>\n"
+            s += "</tr>\n"
+            html_rows.append s
+        end
+        html_rows.append "</table>\n"
+
+        # Coverage Matrices
+        if @project.coverage_matrices.length > 0
+            s = "<h2>Coverage Matrices</h2>\n"
+            s += "<table class=\"controlled\">\n"
+            s += "\t<thead>\n"
+            s += "\t\t<th>Title</th>\n"
+            s += "\t\t<th>Specification Covered</th>\n"
+            s += "</thead>\n"
+            html_rows.append s
+
+            sorted_items = @project.coverage_matrices.sort_by { |w| w.id }
+
+            sorted_items.each do |doc|
+                s = "\t<tr>\n"
+                s += "\t\t<td class=\"item_text\" style='padding: 5px;'><a href=\"./specifications/#{doc.id}/#{doc.id}.html\" class=\"external\">#{doc.title}</a></td>\n"
+                s += "\t\t<td class=\"item_text\" style='width: 25%; padding: 5px;'>#{doc.top_doc.title}</td>\n"
+                s += "</tr>\n"
+                html_rows.append s
+            end
+            html_rows.append "</table>\n"
+        end
+
+        self.save_html_to_file(html_rows, nil, output_file_path)
+        
+    end
+
+
+
+end

data/lib/almirah/doc_types/protocol.rb

@@ -16,7 +16,7 @@ class Protocol < BaseDocument
         #@dictionary = Hash.new
 
         @id = File.basename(fele_path, File.extname(fele_path)).downcase
-        @up_link_doc_id = ""
+        @up_link_doc_id = Hash.new
     end
 
     def to_html(nav_pane, output_file_path)

data/lib/almirah/doc_types/specification.rb

@@ -30,7 +30,7 @@ class Specification < BaseDocument
         @last_used_id_number = 0
 
         @id = File.basename(fele_path, File.extname(fele_path)).downcase
-        @up_link_doc_id = ""
+        @up_link_doc_id = Hash.new
     end
 
     def to_console
@@ -67,7 +67,7 @@ class Specification < BaseDocument
 
         @items.each do |item|    
             a = item.to_html
-            a = adjust_internal_links(a, nav_pane.specifications)
+            #a = adjust_internal_links(a, nav_pane.specifications)
             html_rows.append a
         end
 

data/lib/almirah/doc_types/traceability.rb

@@ -5,16 +5,23 @@ class Traceability < BaseDocument
     attr_accessor :top_doc
     attr_accessor :bottom_doc
     attr_accessor :items
+    attr_accessor :is_agregated
 
-    def initialize(top_doc, bottom_doc)
+    def initialize(top_doc, bottom_doc, is_agregated)
 
         @top_doc = top_doc
         @bottom_doc = bottom_doc
+        @is_agregated = is_agregated
 
         @items = Array.new
         @headings = Array.new
 
-        @id = top_doc.id + "-" + bottom_doc.id
+        if @is_agregated 
+            @id = top_doc.id + "-all"
+        else
+            @id = top_doc.id + "-" + bottom_doc.id
+        end
+
         @title = "Traceability Matrix: " + @id
     end
 
@@ -29,7 +36,10 @@ class Traceability < BaseDocument
         html_rows.append('')
         s = "<h1>#{@title}</h1>\n"
         s += "<table class=\"controlled\">\n"
-        s += "\t<thead> <th>#</th> <th style='font-weight: bold;'>#{@top_doc.title}</th> <th>#</th> <th style='font-weight: bold;'>#{@bottom_doc.title}</th> </thead>\n"
+        s += "\t<thead> <th>#</th> <th style='font-weight: bold;'>#{@top_doc.title}</th> "
+        s += "<th>#</th> <th style='font-weight: bold;'>#{@bottom_doc.title}</th> "
+        s += "<th style='font-weight: bold;'>Document Section</th>"
+        s += "</thead>\n"
         html_rows.append s
 
         sorted_items = @top_doc.controlled_items.sort_by { |w| w.id }
@@ -46,26 +56,57 @@ class Traceability < BaseDocument
 
     def render_table_row(top_item)
         s = ""
+        top_f_text = top_item.format_string( top_item.text )
+
         if top_item.down_links
-            if top_item.down_links.length > 1
-                id_color = "style='background-color: #fff8c5;'"
+
+            if @is_agregated
+
+                if top_item.down_links.length > 1
+                    id_color = "style='background-color: #fff8c5;'"
+                else
+                    id_color = ""
+                end
+
+                top_item.down_links.each do |bottom_item|
+                    bottom_f_text = bottom_item.format_string( bottom_item.text )
+                    document_section = bottom_item.parent_heading.get_section_info
+                    s += "\t<tr>\n"
+                    s += "\t\t<td class=\"item_id\" #{id_color}><a href=\"./../#{top_item.parent_doc.id}/#{top_item.parent_doc.id}.html##{top_item.id}\" class=\"external\">#{top_item.id}</a></td>\n"
+                    s += "\t\t<td class=\"item_text\" style='width: 34%;'>#{top_f_text}</td>\n"
+                    s += "\t\t<td class=\"item_id\"><a href=\"./../#{bottom_item.parent_doc.id}/#{bottom_item.parent_doc.id}.html##{bottom_item.id}\" class=\"external\">#{bottom_item.id}</a></td>\n"
+                    s += "\t\t<td class=\"item_text\" style='width: 34%;'>#{bottom_f_text}</td>\n"
+                    s += "\t\t<td class=\"item_text\" style='width: 16%;'>#{document_section}</td>\n"
+                    s += "\t</tr>\n"
+                end
+
             else
-                id_color = ""
-            end 
-            top_item.down_links.each do |bottom_item|
-                s += "\t<tr>\n"
-                s += "\t\t<td class=\"item_id\" #{id_color}><a href=\"./../#{top_item.parent_doc.id}/#{top_item.parent_doc.id}.html##{top_item.id}\" class=\"external\">#{top_item.id}</a></td>\n"
-                s += "\t\t<td class=\"item_text\" style='width: 42%;'>#{top_item.text}</td>\n"
-                s += "\t\t<td class=\"item_id\"><a href=\"./../#{bottom_item.parent_doc.id}/#{bottom_item.parent_doc.id}.html##{bottom_item.id}\" class=\"external\">#{bottom_item.id}</a></td>\n"
-                s += "\t\t<td class=\"item_text\" style='width: 42%;'>#{bottom_item.text}</td>\n"
-                s += "\t</tr>\n"
+                top_item.down_links.each do |bottom_item|
+
+                    id_color = ""
+
+                    if bottom_item.parent_doc.id == @bottom_doc.id
+
+                        bottom_f_text = bottom_item.format_string( bottom_item.text )
+                        document_section = bottom_item.parent_heading.get_section_info
+
+                        s += "\t<tr>\n"
+                        s += "\t\t<td class=\"item_id\" #{id_color}><a href=\"./../#{top_item.parent_doc.id}/#{top_item.parent_doc.id}.html##{top_item.id}\" class=\"external\">#{top_item.id}</a></td>\n"
+                        s += "\t\t<td class=\"item_text\" style='width: 34%;'>#{top_f_text}</td>\n"
+                        s += "\t\t<td class=\"item_id\"><a href=\"./../#{bottom_item.parent_doc.id}/#{bottom_item.parent_doc.id}.html##{bottom_item.id}\" class=\"external\">#{bottom_item.id}</a></td>\n"
+                        s += "\t\t<td class=\"item_text\" style='width: 34%;'>#{bottom_f_text}</td>\n"
+                        s += "\t\t<td class=\"item_text\" style='width: 16%;'>#{document_section}</td>\n"
+                        s += "\t</tr>\n"
+                    end
+                end
             end
         else
             s += "\t<tr>\n"
             s += "\t\t<td class=\"item_id\"><a href=\"./../#{top_item.parent_doc.id}/#{top_item.parent_doc.id}.html##{top_item.id}\" class=\"external\">#{top_item.id}</a></td>\n"
-            s += "\t\t<td class=\"item_text\" style='width: 42%;'>#{top_item.text}</td>\n"
+            s += "\t\t<td class=\"item_text\" style='width: 34%;'>#{top_f_text}</td>\n"
             s += "\t\t<td class=\"item_id\"></td>\n"
-            s += "\t\t<td class=\"item_text\" style='width: 42%;'></td>\n"
+            s += "\t\t<td class=\"item_text\" style='width: 34%;'></td>\n"
+            s += "\t\t<td class=\"item_text\" style='width: 16%;'></td>\n"
             s += "\t</tr>\n"
         end
         return s

data/lib/almirah/project.rb

@@ -3,20 +3,29 @@ require_relative "doc_fabric"
 require_relative "navigation_pane"
 require_relative "doc_types/traceability"
 require_relative "doc_types/coverage"
+require_relative "doc_types/index"
 
 class Project
 
     attr_accessor :specifications
     attr_accessor :protocols
+    attr_accessor :traceability_matrices
+    attr_accessor :coverage_matrices
     attr_accessor :project_root_directory
     attr_accessor :specifications_dictionary
+    attr_accessor :index
+    attr_accessor :project
 
     def initialize(path)
         @project_root_directory = path
         @specifications = Array.new
         @protocols = Array.new
+        @traceability_matrices = Array.new
+        @coverage_matrices = Array.new
         @specifications_dictionary = Hash.new
-        
+        @index = nil
+        @project = self
+
         FileUtils.remove_dir(@project_root_directory + "/build", true)      
     end
 
@@ -26,8 +35,12 @@ class Project
         parse_all_protocols
         link_all_specifications
         link_all_protocols
-        render_all_specifications
+        create_index
+        render_all_specifications(@specifications)
+        render_all_specifications(@traceability_matrices)
+        render_all_specifications(@coverage_matrices)
         render_all_protocols
+        render_index
     end
 
     def specifications_and_results( test_run )
@@ -36,13 +49,41 @@ class Project
         parse_test_run test_run
         link_all_specifications
         link_all_protocols
-        render_all_specifications
+        create_index
+        render_all_specifications(@specifications)
+        render_all_specifications(@traceability_matrices)
+        render_all_specifications(@coverage_matrices)
         render_all_protocols
+        render_index
+    end
+
+    def transform( file_extension )
+        transform_all_specifications file_extension 
+    end
+
+    def transform_all_specifications( file_extension )
+
+        path = @project_root_directory
+
+        # find all specifications
+        Dir.glob( "#{@project_root_directory}/specifications/**/*.md" ).each do |f|
+            puts f
+            # make a copy with another extention to preserve the content
+            f_directory = File.dirname(f)
+            f_name = File.basename(f, File.extname(f)).downcase + "._md"
+            FileUtils.copy_file( f, "#{f_directory}/#{f_name}")
+            # transform the original one
+            # but do nothing for now - TODO
+        end
     end
 
-    def parse_all_specifications        
+    def parse_all_specifications
+        # do a lasy pass first to get the list of documents id
+        Dir.glob( "#{@project_root_directory}/specifications/**/*.md" ).each do |f|
+            DocFabric.add_lazy_doc_id(f)
+        end
+        # parse documents in the second pass
         Dir.glob( "#{@project_root_directory}/specifications/**/*.md" ).each do |f|
-            puts "Spec: " + f
             doc = DocFabric.create_specification(f)
             @specifications.append(doc)
         end
@@ -68,13 +109,14 @@ class Project
         combList = @specifications.combination(2)
         combList.each do |c|
             link_two_specifications(c[0], c[1])
+            # puts "Link: #{c[0].id} - #{c[1].id}"
         end
     end
 
     def link_all_protocols
         @protocols.each do |p|
             @specifications.each do |s|
-                if s.id == p.up_link_doc_id
+                if p.up_link_doc_id.has_key?(s.id.to_s)
                     link_protocol_to_spec(p,s)
                 end
             end
@@ -83,17 +125,16 @@ class Project
 
     def link_two_specifications(doc_A, doc_B)
 
-        if doc_A.id == doc_B.up_link_doc_id
+        if doc_B.up_link_doc_id.has_key?(doc_A.id.to_s)
             top_document = doc_A
             bottom_document = doc_B
-        elsif doc_B.id == doc_A.up_link_doc_id
+        elsif doc_A.up_link_doc_id.has_key?(doc_B.id.to_s)
             top_document = doc_B
             bottom_document = doc_A
         else
-            puts "No Links"
             return # no links
         end
-        
+        #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)
@@ -108,8 +149,8 @@ class Project
             end
         end
         # create treceability document
-        trx = Traceability.new top_document, bottom_document
-        @specifications.append trx
+        trx = Traceability.new top_document, bottom_document, false
+        @traceability_matrices.append trx
     end
 
     def link_protocol_to_spec(protocol, specification)
@@ -132,19 +173,23 @@ class Project
         end
         # create coverage document
         trx = Coverage.new top_document
-        @specifications.append trx
+        @coverage_matrices.append trx
+    end
+
+    def create_index
+        @index = Index.new( @project )
     end
 
-    def render_all_specifications
+    def render_all_specifications(spec_list)
         
         # create a sidebar first
-        nav_pane = NavigationPane.new(@specifications)        
+        # nav_pane = NavigationPane.new(@specifications)        
 
         pass = @project_root_directory
 
         FileUtils.mkdir_p(pass + "/build/specifications")
     
-        @specifications.each do |doc|
+        spec_list.each do |doc|
 
             doc.to_console
 
@@ -157,14 +202,14 @@ class Project
                 FileUtils.copy_entry( img_src_dir, img_dst_dir )
             end
 
-            doc.to_html( nav_pane, "#{pass}/build/specifications/" )
+            doc.to_html( nil, "#{pass}/build/specifications/" )
         end
     end
 
     def render_all_protocols
         
         # create a sidebar first
-        nav_pane = NavigationPane.new(@specifications)        
+        # nav_pane = NavigationPane.new(@specifications)        
 
         pass = @project_root_directory
 
@@ -182,7 +227,17 @@ class Project
                 FileUtils.copy_entry( img_src_dir, img_dst_dir )
             end
 
-            doc.to_html( nav_pane, "#{pass}/build/tests/protocols/" )
+            doc.to_html( nil, "#{pass}/build/tests/protocols/" )
         end
     end
+
+    def render_index    
+
+        path = @project_root_directory
+
+        doc = @index
+        doc.to_console
+
+        doc.to_html("#{path}/build/")
+    end
 end

data/lib/almirah/templates/page.html

@@ -93,6 +93,7 @@
         border: 1px solid #bbb;
     }
     table.controlled td {
+        padding: 4px;
         text-align:center;
         vertical-align:middle;
         padding-right:10px;
@@ -173,6 +174,15 @@
         font-size: 1.5em;
         font-family: "Trebuchet MS", Verdana, sans-serif;
     }
+    #top_nav a.split {
+        float: right;
+        color: white;
+        text-align: center;
+        padding: 4px 6px;
+        text-decoration: none;
+        font-size: 1.5em;
+        font-family: "Trebuchet MS", Verdana, sans-serif;
+    }
     #top_nav a:hover {
         background-color: black;
         color:  white;
@@ -193,12 +203,31 @@ function closeNav() {
   document.getElementById("nav_pane").style.visibility = "hidden";
   console.log("Mouse Out");
 }
+
+window.onload = (event) => {
+  for (var i = 0, n = document.images.length; i < n; i++) 
+  {
+    elem = document.images[i];
+    if (elem.width > 640)
+    {
+        elem.style.width = "640px";
+    }
+  }
+};
+
+function downlink_OnClick(clicked){
+    clicked.style.display = 'none';
+    id_parts = clicked.id.split("_");
+    required_id = "DLS_" + id_parts[1];
+    document.getElementById(required_id).style.display = 'block';
+}
 </script>
 </head>
 <body>
     <div id="top_nav">
-        <a href="javascript:void(0)" onclick="openNav()"><span><i class="fa fa-bars" aria-hidden="true"></i></span>&nbsp;Navigation</a>
-        <a href="javascript:void(0)"> About</a>
+        <a href="./../../index.html"><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>
     <div id="main">
         <div id="nav_pane">

data/lib/almirah.rb

@@ -2,8 +2,8 @@ require "thor"
 require_relative "almirah/project"
 
 class CLI < Thor
-  desc "please <project_folder>", "say <project_folder>"
   option :results
+  desc "please <project_folder>", "say <project_folder>"
     def please(project_folder)
       a = Almirah.new project_folder
       if options[:results]
@@ -12,6 +12,12 @@ class CLI < Thor
         a.default
       end
     end
+
+  desc "transform <project_folder>", "say <project_folder>"
+  def transform(project_folder)
+    a = Almirah.new project_folder
+    a.transform "docx"
+  end
 end
 
 class Almirah
@@ -30,6 +36,10 @@ class Almirah
     @project.specifications_and_results test_run
   end
 
+  def transform( file_extension )
+    @project.transform file_extension
+  end
+
   def default()
     @project.specifications_and_protocols
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: Almirah
 version: !ruby/object:Gem::Version
-  version: 0.0.9
+  version: 0.1.1
 platform: ruby
 authors:
 - Oleksandr Ivanov
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-03-03 00:00:00.000000000 Z
+date: 2024-03-13 00:00:00.000000000 Z
 dependencies: []
 description: The software part of the Almirah framework
 email: oleksandr.ivanov.development@gmail.com
@@ -33,6 +33,7 @@ files:
 - lib/almirah/doc_items/text_line.rb
 - lib/almirah/doc_types/base_document.rb
 - lib/almirah/doc_types/coverage.rb
+- lib/almirah/doc_types/index.rb
 - lib/almirah/doc_types/protocol.rb
 - lib/almirah/doc_types/specification.rb
 - lib/almirah/doc_types/traceability.rb