Difference between revisions of "Talk:OSIS Genbooks"

From CrossWire Bible Society
Jump to: navigation, search
(bug report duration and focus)
m (bug report cleanup)
 
(30 intermediate revisions by the same user not shown)
Line 88: Line 88:
 
Observe that the level 1 '''div''' elements with <tt>type="majorSection"</tt> had <tt>osisID="Confession"</tt> and <tt>osisID="Appendix"</tt> in the source XML file. Likewise, the level 2 '''div''' elements with <tt>type="chapter"</tt> had <tt>osisID="Introduction"</tt> and <tt>osisID="Section 1"</tt>, etc. The use of the <tt>/</tt> separator within the module structure is why this separator is required in each internal '''osisRef''' string in order to make it work as a link. [[User:David Haslam|David Haslam]] ([[User talk:David Haslam|talk]]) 08:49, 25 June 2020 (UTC)
 
Observe that the level 1 '''div''' elements with <tt>type="majorSection"</tt> had <tt>osisID="Confession"</tt> and <tt>osisID="Appendix"</tt> in the source XML file. Likewise, the level 2 '''div''' elements with <tt>type="chapter"</tt> had <tt>osisID="Introduction"</tt> and <tt>osisID="Section 1"</tt>, etc. The use of the <tt>/</tt> separator within the module structure is why this separator is required in each internal '''osisRef''' string in order to make it work as a link. [[User:David Haslam|David Haslam]] ([[User talk:David Haslam|talk]]) 08:49, 25 June 2020 (UTC)
  
== Example OSIS Genbook - test ==
 
  
The example/tutorial was developed a little more, but is not yet complete as described at this [https://github.com/sword-2/library/tree/master/docs/genbooks link]. No table of contents was observed for this module in the bishop app after installation.
+
:An attempt was made to analyze the status [https://sword-2.github.io/sword-wiki/CDE/CC-DA/genbooks/BaptistConfession1646/ here]. One limitation was that an original XML file was not known from the baptists. There were other formats like [https://www.nobts.edu/baptist-center-theology/baptist-confessions.html The New Orleans Baptist Theological seminary (NOBTS) pdf].
 +
 
 +
:[[User:Gregs650|Gregs650]] ([[User talk:Gregs650|talk]]) 23:34, 14 March 2023 (UTC)
 +
 
 +
== Tutorial test ==
 +
 
 +
The example/tutorial for this page was tried as explained [https://sword-2.github.io/sword-wiki/CDE/CC-DA/genbooks/OSISGenbooksTutorial/ here] but was not completed successfully.
 +
 
  
 
--[[User:Gregs650|Gregs650]] ([[User talk:Gregs650|talk]]) 22:13, 28 February 2023 (UTC)
 
--[[User:Gregs650|Gregs650]] ([[User talk:Gregs650|talk]]) 22:13, 28 February 2023 (UTC)
  
== bug report duration and focus ==
+
== bug report cleanup ==
 +
 
 +
The subsection “Making a Genbook module” noted a Windows bug. Matthew 18:15-17 might be an option to handle a new bug. Bugs already circulating on the net maybe don't count for Matthew 18.
  
The subsection “Making a Genbook module” noted a Windows bug. Some details for the bug could help know when the bug report can be removed. Identifying the bug's details may help understand when the fix has been completed, and when the bug can be removed. Otherwise, the bug's duration could be too long (Leviticus 19:15-16).
+
[https://stackoverflow.com/questions/8598354/why-is-msvc10-ignoring-my-pragma-warningdisable-4251 This] article reported an issue already circulating about a bunch of warnings for a certain compiler due to the following lines of code below. Was the reference to this existing bug/issue?
  
If the bug was reported to the crosswire [http://crosswire.org/sword/support/index.jsp support] page, the description might allow re-posting it to an applicable software board too, for more advice. It is currently unclear whether there was a bug report.
+
<pre>
 +
#ifdef _MSC_VER
 +
    #pragma warning( disable: 4251)
 +
#endif
 +
</pre>
 
--[[User:Gregs650|Gregs650]] ([[User talk:Gregs650|talk]]) 19:23, 1 March 2023 (UTC)
 
--[[User:Gregs650|Gregs650]] ([[User talk:Gregs650|talk]]) 19:23, 1 March 2023 (UTC)
  
== Root node links not found ==
+
== Source code analysis for xml2gbs ==
  
Three of the 4 links in the root element were "not found" when entered into a web browser. Another [https://wiki.crosswire.org/OSIS_211_CR#Bible_Technologies_Group page] predicted this, that the domain www.bibletechnologies.net will no longer work.
+
The source code for this utility was being analyzed [https://sword-2.github.io/sword-wiki/CDE/CP-Computational_Problems/utilities/xml2gbs/html/index.html here]. The purpose was to solve the computational problem of why custom modules and the tutorial had not loaded successfully to a SWORD app.  
  
OSIS newbies might not be prepared for the browser to report "not found". One reason includes stack overflow answers. One stack overflow post [https://stackoverflow.com/questions/5875021/what-is-the-use-of-xsischemalocation what is the use of xsi:schemaLocation?] had a question about a root tag <beans ...>. An answer at the end by Mojun Zhu said "If you go into any of those locations, then you will find what is defined in those schema."
 
 
--[[User:Gregs650|Gregs650]] ([[User talk:Gregs650|talk]]) 19:49, 4 March 2023 (UTC)
 
--[[User:Gregs650|Gregs650]] ([[User talk:Gregs650|talk]]) 19:49, 4 March 2023 (UTC)

Latest revision as of 21:13, 9 June 2023

Internal structure of a Genbook module made using xml2gbs

xml2gbs 1.0 is the OSIS/ThML/TEI General Book module creation tool for the SWORD Project.

The XML multilevel div element structure is converted by xml2gbs to a module internal structure that seems to deviate from the strict specification for OSIS. For example, the output of mod2imp BaptistConfession1646 contains the following IMP format references:

$$$
$$$/Confession
$$$/Confession/Introduction
$$$/Confession/Section 1
$$$/Confession/Section 2
$$$/Confession/Section 3
$$$/Confession/Section 4
$$$/Confession/Section 5
$$$/Confession/Section 6
$$$/Confession/Section 7
$$$/Confession/Section 8
$$$/Confession/Section 9
$$$/Confession/Section 10
$$$/Confession/Section 11
$$$/Confession/Section 12
$$$/Confession/Section 13
$$$/Confession/Section 14
$$$/Confession/Section 15
$$$/Confession/Section 16
$$$/Confession/Section 17
$$$/Confession/Section 18
$$$/Confession/Section 19
$$$/Confession/Section 20
$$$/Confession/Section 21
$$$/Confession/Section 22
$$$/Confession/Section 23
$$$/Confession/Section 24
$$$/Confession/Section 25
$$$/Confession/Section 26
$$$/Confession/Section 27
$$$/Confession/Section 28
$$$/Confession/Section 29
$$$/Confession/Section 30
$$$/Confession/Section 31
$$$/Confession/Section 32
$$$/Confession/Section 33
$$$/Confession/Section 34
$$$/Confession/Section 35
$$$/Confession/Section 36
$$$/Confession/Section 37
$$$/Confession/Section 38
$$$/Confession/Section 39
$$$/Confession/Section 40
$$$/Confession/Section 41
$$$/Confession/Section 42
$$$/Confession/Section 43
$$$/Confession/Section 44
$$$/Confession/Section 45
$$$/Confession/Section 46
$$$/Confession/Section 47
$$$/Confession/Section 48
$$$/Confession/Section 49
$$$/Confession/Section 50
$$$/Confession/Section 51
$$$/Confession/Section 52
$$$/Confession/Conclusion
$$$/Appendix
$$$/Appendix/Appx_Introduction
$$$/Appendix/Appx_Section 1
$$$/Appendix/Appx_Section 2
$$$/Appendix/Appx_Section 3
$$$/Appendix/Appx_Section 4
$$$/Appendix/Appx_Section 5
$$$/Appendix/Appx_Section 6
$$$/Appendix/Appx_Section 7
$$$/Appendix/Appx_Section 8
$$$/Appendix/Appx_Section 9
$$$/Appendix/Appx_Section 10
$$$/Appendix/Appx_Section 11
$$$/Appendix/Appx_Section 12
$$$/Appendix/Appx_Section 13
$$$/Appendix/Appx_Section 14
$$$/Appendix/Appx_Section 15
$$$/Appendix/Appx_Section 16
$$$/Appendix/Appx_Section 17
$$$/Appendix/Appx_Section 18
$$$/Appendix/Appx_Section 19
$$$/Appendix/Appx_Section 20
$$$/Appendix/Appx_Section 21
$$$/Appendix/Appx_Section 22

Observe that the level 1 div elements with type="majorSection" had osisID="Confession" and osisID="Appendix" in the source XML file. Likewise, the level 2 div elements with type="chapter" had osisID="Introduction" and osisID="Section 1", etc. The use of the / separator within the module structure is why this separator is required in each internal osisRef string in order to make it work as a link. David Haslam (talk) 08:49, 25 June 2020 (UTC)


An attempt was made to analyze the status here. One limitation was that an original XML file was not known from the baptists. There were other formats like The New Orleans Baptist Theological seminary (NOBTS) pdf.
Gregs650 (talk) 23:34, 14 March 2023 (UTC)

Tutorial test

The example/tutorial for this page was tried as explained here but was not completed successfully.


--Gregs650 (talk) 22:13, 28 February 2023 (UTC)

bug report cleanup

The subsection “Making a Genbook module” noted a Windows bug. Matthew 18:15-17 might be an option to handle a new bug. Bugs already circulating on the net maybe don't count for Matthew 18.

This article reported an issue already circulating about a bunch of warnings for a certain compiler due to the following lines of code below. Was the reference to this existing bug/issue?

#ifdef _MSC_VER
     #pragma warning( disable: 4251)
#endif

--Gregs650 (talk) 19:23, 1 March 2023 (UTC)

Source code analysis for xml2gbs

The source code for this utility was being analyzed here. The purpose was to solve the computational problem of why custom modules and the tutorial had not loaded successfully to a SWORD app.

--Gregs650 (talk) 19:49, 4 March 2023 (UTC)