ttl2html 3.0.0 → 3.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8120a06f3f763ca13d8b9f35c920f9129d57876a5dde434b264c052bd1aa9151
-  data.tar.gz: 9d1cd9d09f5a14a5d56856c00099b38abe059a9c27f775df2074b42db99e9a7a
+  metadata.gz: 5d181672a5b0aa4cd6f7f1599fb20b6102c5232b3f774069038023bfc65d05a0
+  data.tar.gz: 313970beef022f77e7f4d5bac9da410adcc6203a6dd7d073d6ab2b49a516ebae
 SHA512:
-  metadata.gz: 4935a3824f19a696ea4657d652c4afd482af6a8a2e33aa98725d4739375480654b86dd4a9781dae357d816d422dc7807a974bb7dfb38fbe1d6cb5d84a84a3792
-  data.tar.gz: 9e561cb7abbfc195e8a13f09af9161a0b88f301e73b040ab149707e5f47905728a9ed603210b9f2818771350fd11670072941df4b58d92e4f5c268c608845274
+  metadata.gz: fdd4152bfc2ab82d97bed51c63dd8814e89a40b31d2e84ca2a64406dcfd4be373a393ccf8b2ebd477adb8e1f4df844f355872537232e7ec9357063ff2c123760
+  data.tar.gz: 7821d98735d0fadf33671017573accb9d765e2e2bd571c9fb66435251a056cedab6e05ec20b760c940cc2f1daa16bbdde11496cadcf4045fa9016344904e36db

data/lib/ttl2html/template.rb

@@ -98,12 +98,24 @@ module TTL2HTML
           end
           #p nodes
         end
+        example = data[property]["http://www.w3.org/2004/02/skos/core#example"].first if data[property]["http://www.w3.org/2004/02/skos/core#example"]
+        if example.respond_to?(:datatype) and example.datatype?
+          datatype = example.datatype.pname or example.datatype.to_s
+          example = example.to_s + "<span class=\"datatype\">^^" + example.datatype.pname + "</span>"
+        end
+        descriptions = [ get_language_literal(data[property]["http://www.w3.org/ns/shacl#description"]) ]
+        if data[property]["http://www.w3.org/ns/shacl#datatype"]
+          datatypes = data[property]["http://www.w3.org/ns/shacl#datatype"].map do |datatype|
+            datatype.to_s.sub(%r{\Ahttp://www\.w3\.org/2001/XMLSchema#}, 'xsd:')
+          end.join(", ")
+          descriptions << t('shape-table.datatype') + datatypes
+        end
         {
           path: path,
           shorten_path: shorten_path,
           name: get_language_literal(data[property]["http://www.w3.org/ns/shacl#name"]),
-          example: data[property]["http://www.w3.org/2004/02/skos/core#example"] ? data[property]["http://www.w3.org/2004/02/skos/core#example"].first : nil,
-          description: get_language_literal(data[property]["http://www.w3.org/ns/shacl#description"]),
+          example: example,
+          description: descriptions.compact.join("<br>"),
           required: data[property]["http://www.w3.org/ns/shacl#minCount"] ? data[property]["http://www.w3.org/ns/shacl#minCount"].first.to_i > 0 : false,
           repeatable: repeatable,
           nodeKind: data[property]["http://www.w3.org/ns/shacl#nodeKind"] ? data[property]["http://www.w3.org/ns/shacl#nodeKind"].first : nil,

data/lib/ttl2html/version.rb

@@ -1 +1 @@
-TTL2HTML::VERSION = "3.0.0"
+TTL2HTML::VERSION = "3.1.1"

data/lib/ttl2html.rb

@@ -72,9 +72,31 @@ module TTL2HTML
       $stderr.puts "#{count} triples. #{subjects.size} subjects."
       @data
     end
-    def format_turtle(subject, depth = 1)
+    QB_ORDER_URI = "http://purl.org/linked-data/cube#order"
+    SCHEMA_POSITION_URI = "http://schema.org/position"
+    SHACL_ORDER_URI = "http://www.w3.org/ns/shacl#order"
+    def sort_key_for_resource(resource, depth = 1)
+      qb_order = Float::INFINITY
+      schema_position = Float::INFINITY
+      shacl_order = Float::INFINITY
+      if @data[resource.to_s]
+        qb_order = @data[resource.to_s][QB_ORDER_URI].first.to_i if @data[resource.to_s][QB_ORDER_URI]
+        schema_position = @data[resource.to_s][SCHEMA_POSITION_URI].first.to_i if @data[resource.to_s][SCHEMA_POSITION_URI]
+        shacl_order = @data[resource.to_s][SHACL_ORDER_URI].first.to_i if @data[resource.to_s][SHACL_ORDER_URI]
+      end
+      if resource.to_s =~ /^_:/ and depth < 5
+        [ schema_position, qb_order, shacl_order,
+          format_turtle(resource, depth + 1, true)
+        ]
+      else
+        [ schema_position, qb_order, shacl_order, resource.to_s]
+      end
+    end
+    def format_turtle(subject, depth = 1, force = false)
       turtle = RDF::Turtle::Writer.new
       result = ""
+      #p [:format_turtle, subject, depth, force]
+      return result if !force && @cache[:output_turtle_files].include?(subject)
       if subject =~ /^_:/
         result << "[\n#{"  "*depth}"
       else
@@ -85,21 +107,10 @@ module TTL2HTML
         #p [subject, predicate, @data[subject.to_s][predicate]]
         str << @data[subject.to_s][predicate].sort_by do |object|
           #p [subject, predicate, object, depth]
-          if object.to_s =~ /^_:/ and @data[object.to_s]
-            qb_order = "http://purl.org/linked-data/cube#order"
-            schema_position = "http://schema.org/position"
-            shacl_order = "http://www.w3.org/ns/shacl#order"
-            [ @data[object.to_s][schema_position] ? @data[object.to_s][schema_position].first.to_i : Float::INFINITY,
-              @data[object.to_s][qb_order] ? @data[object.to_s][qb_order].first.to_i : Float::INFINITY,
-              @data[object.to_s][shacl_order] ? @data[object.to_s][shacl_order].first.to_i : Float::INFINITY,
-              format_turtle(object, depth + 1)
-            ]
-          else
-            [Float::INFINITY, Float::INFINITY, Float::INFINITY, object.to_s]
-          end
+          sort_key_for_resource(object, depth)
         end.map do |object|
           if /^_:/ =~ object.to_s # blank node:
-            format_turtle(object, depth + 1)
+            format_turtle(object, depth + 1, force)
           elsif RDF::URI::IRI =~ object.to_s
             turtle.format_uri(RDF::URI.new object)
           elsif object.respond_to?(:first) and object.first.kind_of?(Symbol)
@@ -110,22 +121,117 @@ module TTL2HTML
         end.join(", ")
         str
       end.join(";\n#{"  "*depth}")
-      result << " ." if not subject =~ /^_:/
+      result << "." if not subject =~ /^_:/
       result << "\n"
       result << "#{"  "*(depth-1)}]" if subject =~ /^_:/
+      @cache[:output_turtle_files] << subject unless force
       result
     end
     def format_turtle_inverse(object)
-      result = ""
-      return result if not object.start_with? @config[:base_uri]
-      return result if not @data_inverse.has_key? object
-      @data_inverse[object].keys.sort.each do |predicate|
-        @data_inverse[object.to_s][predicate].sort.each do |subject|
-          next if subject =~ /^_:/
-          result << "<#{subject}> <#{predicate}> <#{object}>.\n"
+      triples = collect_inverse_triples(object)
+      return "" if triples.empty?
+      by_subject = build_subject_index(triples)
+      ref_count  = build_object_ref_count(triples)
+      roots      = find_inverse_roots(by_subject)
+      roots.map do |root|
+        "#{format_inverse_subject(root, by_subject, ref_count, Set.new, 1)}.\n"
+      end.join
+    end
+    def collect_inverse_triples(object, triples = Set.new, visited = Set.new)
+      return triples if object.to_s.start_with?("_:")
+      return triples unless object.to_s.start_with?(@config[:base_uri].to_s)
+      return triples unless @data_inverse.key?(object.to_s)
+      return triples if visited.include?(object.to_s)
+      visited << object.to_s
+      @data_inverse[object.to_s].each do |predicate, subjects|
+        subjects.each do |subject|
+          triples << [subject.to_s, predicate.to_s, object.to_s]
+          collect_inverse_triples_for_bnode(subject.to_s, triples, visited) if subject.to_s.start_with?("_:")
         end
       end
-      result
+      triples
+    end
+    def collect_inverse_triples_for_bnode(node, triples, visited)
+      return triples unless @data_inverse.key?(node)
+      return triples if visited.include?(node)
+      visited << node
+      @data_inverse[node].each do |predicate, subjects|
+        subjects.each do |subject|
+            triples << [subject.to_s, predicate.to_s, node]
+            collect_inverse_triples_for_bnode(subject.to_s, triples, visited) if subject.to_s.start_with?("_:")
+        end
+      end
+      triples
+    end
+    def build_subject_index(triples)
+      by_subject = Hash.new { |h, k| h[k] = Hash.new { |hh, kk| hh[kk] = [] } }
+      triples.each do |subject, predicate, object|
+        by_subject[subject][predicate] << object
+      end
+      by_subject.each_value do |predicates|
+        predicates.each_value(&:uniq!)
+      end
+      by_subject
+    end
+    def build_object_ref_count(triples)
+      count = Hash.new(0)
+      triples.each do |_subject, _predicate, object|
+        count[object] += 1 if object.to_s.start_with?("_:")
+      end
+      count
+    end
+    def find_inverse_roots(by_subject)
+      all_subjects = by_subject.keys
+      all_objects  = by_subject.values.flat_map { |preds| preds.values.flatten }.uniq
+      all_subjects.reject do |subject|
+        subject.start_with?("_:") || all_objects.include?(subject)
+      end.sort
+    end
+    def format_inverse_subject(subject, by_subject, ref_count, visited, depth = 1)
+      props = by_subject[subject]
+      return format_node(subject) if props.nil? || props.empty?
+      indent = "  " * (depth - 1)
+      inner  = "  " * depth
+      if subject.start_with?("_:")
+        return "[]" if visited.include?(subject)
+        visited = visited.dup
+        visited << subject
+        head = "[\n#{inner}"
+        tail = "\n#{indent}]"
+      else
+        head = "<#{subject}> "
+        tail = ""
+      end
+      body = props.keys.sort.map do |predicate|
+        objects = props[predicate].sort.map do |object|
+          format_inverse_object(object, by_subject, ref_count, visited, depth + 1)
+        end.join(", ")
+        "<#{predicate}> #{objects}"
+      end.join(";\n#{inner}")
+      head + body + tail
+    end
+    def format_inverse_object(object, by_subject, ref_count, visited, depth = 1)
+      if object.to_s.start_with?("_:") && by_subject.key?(object.to_s)
+        if ref_count[object.to_s] <= 1
+          format_inverse_subject(object.to_s, by_subject, ref_count, visited, depth)
+        else
+          object.to_s
+        end
+      else
+        format_node(object)
+      end
+    end
+    def format_node(value)
+      turtle = RDF::Turtle::Writer.new
+      if value.to_s.start_with?("_:")
+        value.to_s
+      elsif RDF::URI::IRI =~ value.to_s
+        "<#{value}>"
+      elsif value.respond_to?(:first) && value.first.kind_of?(Symbol)
+        turtle.format_literal(RDF::Literal.new(value[1], language: value[0]))
+      else
+        turtle.format_literal(value)
+      end
     end
 
     def each_data(label = :each_data)
@@ -218,7 +324,9 @@ module TTL2HTML
           param[:versions] = versions
           param[:toplevel] = toplevel
           param[:description] = template.to_html_raw("description.html", {}) if template.find_template_path("description.html")
-          subjects.sort.each do |subject|
+          subjects.sort_by do |subject|
+            sort_key_for_resource(subject)
+          end.each do |subject|
             objects = []
             if @config.has_key? :top_additional_property
               @config[:top_additional_property].each do |property|
@@ -521,6 +629,8 @@ module TTL2HTML
         end
         dir = File.dirname(file)
         FileUtils.mkdir_p(dir) if not File.exist?(dir)
+        @cache ||= {}
+        @cache[:output_turtle_files] = Set.new
         str = format_turtle(uri)
         str << format_turtle_inverse(uri)
         open(file, "w") do |io|

data/locales/en.yml

@@ -45,6 +45,7 @@ en:
     non-repeatable: "Non repeatable"
     blank-node-structure: "The structural contents of a blank node are as follows:"
     blank-node-or-structure: "The structural contents of a blank node are either of the followings:"
+    datatype: "Datatype: "
   triples:
     inverse_refered: "Referred to as '%{property}' from:"
     blank_node: "Blank node"

data/locales/ja.yml

@@ -45,6 +45,7 @@ ja:
     non-repeatable: 繰り返し無し
     blank-node-structure: ブランクノードの内容は以下の内容からなる構造を持ちます。
     blank-node-or-structure: ブランクノードの内容は以下のいずれかの内容からなる構造を持ちます。
+    datatype: "データ型: "
   triples:
     inverse_refered: "'%{property}'としての参照元:"
     blank_node: "空ノード"

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: ttl2html
 version: !ruby/object:Gem::Version
-  version: 3.0.0
+  version: 3.1.1
 platform: ruby
 authors:
 - Masao Takaku
 bindir: bin
 cert_chain: []
-date: 2026-04-08 00:00:00.000000000 Z
+date: 2026-04-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: nokogiri
@@ -210,7 +210,9 @@ files:
 homepage: https://github.com/masao/ttl2html
 licenses:
 - MIT
-metadata: {}
+metadata:
+  bug_tracker_uri: https://github.com/masao/ttl2html/issues
+  documentation_uri: https://ttl2html-doc.readthedocs.io/
 rdoc_options: []
 require_paths:
 - lib
@@ -225,7 +227,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.3
+rubygems_version: 4.0.10
 specification_version: 4
 summary: ttl2html
 test_files: []