File Formats - Revision history

David Haslam: /* The SWORD Project Utilities */ 2025-07-08 A new version of the Windows tools updated to '''SVN r3906''' has been posted [https://src.thehellings.com/greg/mingw-sword-build/-/releases here].

2025-07-09T15:41:09Z

The SWORD Project Utilities: <ref>2025-07-08 A new version of the Windows tools updated to '''SVN r3906''' has been posted [https://src.thehellings.com/greg/mingw-sword-build/-/releases here].</ref>

← Older revision		Revision as of 15:41, 9 July 2025
Line 11:		Line 11:

	==The SWORD Project Utilities==		==The SWORD Project Utilities==
	Precompiled versions of many of these programs are available in most '''Linux''' distributions, using the distribution's package installer.<BR>For '''Windows''', they can be found [https://github.com/devroles/mingw_sword_package here].<ref>If you have '''Xiphos''' installed in Windows, the Sword utilities are available in the Xiphos\bin folder.</ref><ref>The latest binaries may be found [https://github.com/devroles/mingw_sword_package/releases/tag/1.9.0a here], though currently without cipherraw.exe</ref>		Precompiled versions of many of these programs are available in most '''Linux''' distributions, using the distribution's package installer.<BR>For '''Windows''', they can be found [https://github.com/devroles/mingw_sword_package here].<ref>If you have '''Xiphos''' installed in Windows, the Sword utilities are available in the Xiphos\bin folder.</ref><ref>The latest binaries may be found [https://github.com/devroles/mingw_sword_package/releases/tag/1.9.0a here], though currently without cipherraw.exe</ref><ref>2025-07-08 A new version of the Windows tools updated to '''SVN r3906''' has been posted [https://src.thehellings.com/greg/mingw-sword-build/-/releases here].</ref>

	===Module Creation Tools===		===Module Creation Tools===

David Haslam: /* USFM */ https://paratext.org/download/ Paratext 9.4

2024-11-23T11:13:01Z

USFM: https://paratext.org/download/ Paratext 9.4

← Older revision		Revision as of 11:13, 23 November 2024
Line 55:		Line 55:
	[http://paratext.org/usfm ''Unified Standard Format Markers'']		[http://paratext.org/usfm ''Unified Standard Format Markers'']

	This plain-text format is a common internal-use format within Bible translation agencies and Bible societies. It is the native format of [http://paratext.org/ ~~ParaTExt~~]. Paratext is used by more than 60% of all Bible translators world-wide. The current release is [https://~~pt8.~~paratext.org/ ~~ParaTExt 8~~.0].		This plain-text format is a common internal-use format within Bible translation agencies and Bible societies. It is the native format of [http://paratext.org/ Paratext]. Paratext is used by more than 60% of all Bible translators world-wide. The current release is [https://paratext.org/download/ Paratext 9.4].

	Though '''USFM 2.4''' suffices for most Bibles, [https://ubsicap.github.io/usfm/ USFM 3.0] is now available and has several new features. The standard is open source and is maintained at [https://github.com/ubsicap/usfm ubsicap/usfm].		Though '''USFM 2.4''' suffices for most Bibles, [https://ubsicap.github.io/usfm/ USFM 3.0] is now available and has several new features. The standard is open source and is maintained at [https://github.com/ubsicap/usfm ubsicap/usfm].

David Haslam: /* The SWORD Project Utilities */

2021-02-20T12:11:26Z

The SWORD Project Utilities: <BR>

← Older revision		Revision as of 12:11, 20 February 2021
Line 11:		Line 11:

	==The SWORD Project Utilities==		==The SWORD Project Utilities==
	Precompiled versions of many of these programs are available in most Linux distributions, using the distribution's package installer. For Windows, they can be found [https://github.com/devroles/mingw_sword_package here].<ref>If you have Xiphos installed in Windows, the Sword utilities are available in the Xiphos\bin folder.</ref><ref>The latest binaries may be found [https://github.com/devroles/mingw_sword_package/releases/tag/1.9.0a here], though currently without cipherraw.exe</ref>		Precompiled versions of many of these programs are available in most '''Linux''' distributions, using the distribution's package installer.<BR>For '''Windows''', they can be found [https://github.com/devroles/mingw_sword_package here].<ref>If you have '''Xiphos''' installed in Windows, the Sword utilities are available in the Xiphos\bin folder.</ref><ref>The latest binaries may be found [https://github.com/devroles/mingw_sword_package/releases/tag/1.9.0a here], though currently without cipherraw.exe</ref>

	===Module Creation Tools===		===Module Creation Tools===

David Haslam: /* The SWORD Project Utilities */ [https://github.com/devroles/mingw_sword_package/releases/tag/1.9.0a here]

2021-02-20T12:10:04Z

The SWORD Project Utilities: [https://github.com/devroles/mingw_sword_package/releases/tag/1.9.0a here]

← Older revision		Revision as of 12:10, 20 February 2021
Line 11:		Line 11:

	==The SWORD Project Utilities==		==The SWORD Project Utilities==
	Precompiled versions of many of these programs are available in most Linux distributions, using the distribution's package installer. For Windows, they can be found [https://github.com/devroles/mingw_sword_package here].<ref>If you have Xiphos installed in Windows, the Sword utilities are available in the Xiphos\bin folder.</ref><ref>The latest binaries may be found [https://github.com/devroles/mingw_sword_package here], though currently without cipherraw.exe</ref>		Precompiled versions of many of these programs are available in most Linux distributions, using the distribution's package installer. For Windows, they can be found [https://github.com/devroles/mingw_sword_package here].<ref>If you have Xiphos installed in Windows, the Sword utilities are available in the Xiphos\bin folder.</ref><ref>The latest binaries may be found [https://github.com/devroles/mingw_sword_package/releases/tag/1.9.0a here], though currently without cipherraw.exe</ref>

	===Module Creation Tools===		===Module Creation Tools===

David Haslam: /* The SWORD Project Utilities */ [https://github.com/devroles/mingw_sword_package here]

2021-02-20T12:08:20Z

The SWORD Project Utilities: [https://github.com/devroles/mingw_sword_package here]

← Older revision		Revision as of 12:08, 20 February 2021
Line 11:		Line 11:

	==The SWORD Project Utilities==		==The SWORD Project Utilities==
	Precompiled versions of many of these programs are available in most Linux distributions, using the distribution's package installer. For Windows, they can be found [~~http~~://~~crosswire~~.~~org~~/~~ftpmirror~~/~~pub/sword/utils/win32~~ here].<ref>If you have Xiphos installed in Windows, the Sword utilities are available in the Xiphos\bin folder.</ref><ref>The latest binaries may be found [https://github.com/devroles/mingw_sword_package here], though currently without cipherraw.exe</ref>		Precompiled versions of many of these programs are available in most Linux distributions, using the distribution's package installer. For Windows, they can be found [https://github.com/devroles/mingw_sword_package here].<ref>If you have Xiphos installed in Windows, the Sword utilities are available in the Xiphos\bin folder.</ref><ref>The latest binaries may be found [https://github.com/devroles/mingw_sword_package here], though currently without cipherraw.exe</ref>

	===Module Creation Tools===		===Module Creation Tools===

David Haslam: /* The SWORD Project Utilities */ The latest binaries may be found [https://github.com/devroles/mingw_sword_package here], though currently without cipherraw.exe

2021-02-20T12:07:20Z

The SWORD Project Utilities: <ref>The latest binaries may be found [https://github.com/devroles/mingw_sword_package here], though currently without cipherraw.exe</ref>

← Older revision		Revision as of 12:07, 20 February 2021
Line 11:		Line 11:

	==The SWORD Project Utilities==		==The SWORD Project Utilities==
	Precompiled versions of many of these programs are available in most Linux distributions, using the distribution's package installer. For Windows, they can be found [http://crosswire.org/ftpmirror/pub/sword/utils/win32 here].<ref>If you have Xiphos installed in Windows, the Sword utilities are available in the Xiphos\bin folder.</ref><ref>The latest binaries may be found [~~http~~://~~dl.thehellings~~.com/~~sword-utils~~/ here], though currently without cipherraw.exe ~~(Link broken!)~~</ref>		Precompiled versions of many of these programs are available in most Linux distributions, using the distribution's package installer. For Windows, they can be found [http://crosswire.org/ftpmirror/pub/sword/utils/win32 here].<ref>If you have Xiphos installed in Windows, the Sword utilities are available in the Xiphos\bin folder.</ref><ref>The latest binaries may be found [https://github.com/devroles/mingw_sword_package here], though currently without cipherraw.exe</ref>

	===Module Creation Tools===		===Module Creation Tools===

David Haslam: /* Recommended Non-SWORD Utilities */ –

2020-07-17T14:53:08Z

Recommended Non-SWORD Utilities: –

← Older revision		Revision as of 14:53, 17 July 2020
Line 46:		Line 46:

	===Recommended Non-SWORD Utilities===		===Recommended Non-SWORD Utilities===
	* uconv - a utility from [http://icu-project.org/ ICU] for converting between various character encodings, perform normalization, transliterate texts, etc. (It's similar to iconv, but much, much more powerful.) uconv.exe is part of the [http://crosswire.org/ftpmirror/pub/sword/utils/win32 sword utilities]		* uconv – a utility from [http://icu-project.org/ ICU] for converting between various character encodings, perform normalization, transliterate texts, etc. (It's similar to iconv, but much, much more powerful.) uconv.exe is part of the [http://crosswire.org/ftpmirror/pub/sword/utils/win32 sword utilities]
	* xmllint - a utility (part of the [http://xmlsoft.org/ libxml2] distribution) for validating XML documents [http://crosswire.org/ftpmirror/pub/sword/utils/win32 *]		* xmllint – a utility (part of the [http://xmlsoft.org/ libxml2] distribution) for validating XML documents [http://crosswire.org/ftpmirror/pub/sword/utils/win32 *]

	==Formats for which CrossWire maintains converters==		==Formats for which CrossWire maintains converters==

David Haslam: /* SWORD modules */ [https://tei-c.org/ TEI]

2020-07-17T14:50:32Z

SWORD modules: [https://tei-c.org/ TEI]

← Older revision		Revision as of 14:50, 17 July 2020
Line 8:		Line 8:
	Our module file format is proprietary in the sense that we see no need to document it and certainly no need to stick to it. We change it when we need to. We therefore do not encourage direct interaction with it, but firmly recommend use of the API (either C++ or Java). This is the place where we seek stability and consistency.		Our module file format is proprietary in the sense that we see no need to document it and certainly no need to stick to it. We change it when we need to. We therefore do not encourage direct interaction with it, but firmly recommend use of the API (either C++ or Java). This is the place where we seek stability and consistency.

	The SWORD Project supports currently and actively the following markup for module creation: OSIS, TEI, ThML and plain text.		The SWORD Project supports currently and actively the following markup for module creation: OSIS, [https://tei-c.org/ TEI], ThML and plain text.

	==The SWORD Project Utilities==		==The SWORD Project Utilities==

David Haslam: /* Miscellaneous */ –

2020-07-17T14:44:24Z

Miscellaneous: –

← Older revision		Revision as of 14:44, 17 July 2020
Line 37:		Line 37:

	===Miscellaneous===		===Miscellaneous===
	* cipherraw - used to encipher SWORD modules [http://crosswire.org/ftpmirror/pub/sword/utils/win32 &dagger;]		* cipherraw – used to encipher SWORD modules [http://crosswire.org/ftpmirror/pub/sword/utils/win32 &dagger;]
	* [[Frontends:Diatheke\|diatheke]] - a basic CLI SWORD front-end [http://crosswire.org/ftpmirror/pub/sword/utils/win32 &dagger;]		* [[Frontends:Diatheke\|diatheke]] – a basic CLI SWORD front-end [http://crosswire.org/ftpmirror/pub/sword/utils/win32 &dagger;]
	* [[mkfastmod]] - creates a search index for a module<ref>Aside: To create a list of installed modules with descriptions, enter the following command, optionally redirecting stderr to a log file.<pre>mkfastmod /? 2>mkfastmod.log</pre></ref> [http://crosswire.org/ftpmirror/pub/sword/utils/win32 &dagger;]		* [[mkfastmod]] – creates a search index for a module<ref>Aside: To create a list of installed modules with descriptions, enter the following command, optionally redirecting stderr to a log file.<pre>mkfastmod /? 2>mkfastmod.log</pre></ref> [http://crosswire.org/ftpmirror/pub/sword/utils/win32 &dagger;]
	* [[mod2zmod]] - creates a compressed module from an installed module [http://crosswire.org/ftpmirror/pub/sword/utils/win32 &dagger;]		* [[mod2zmod]] – creates a compressed module from an installed module [http://crosswire.org/ftpmirror/pub/sword/utils/win32 &dagger;]
	==== Notes on SWORD Tools ====		==== Notes on SWORD Tools ====

David Haslam: /* OSIS Utilities */ –

2020-07-17T14:43:58Z

OSIS Utilities: –

← Older revision		Revision as of 14:43, 17 July 2020
Line 33:		Line 33:

	===OSIS Utilities===		===OSIS Utilities===
	* vs2osisref - returns the osisRef of a given (text form) verse reference [http://crosswire.org/ftpmirror/pub/sword/utils/win32 &dagger;]		* vs2osisref – returns the osisRef of a given (text form) verse reference [http://crosswire.org/ftpmirror/pub/sword/utils/win32 &dagger;]
	* xml2gbs - imports free-form General books in OSIS or ThML format to SWORD format [http://crosswire.org/ftpmirror/pub/sword/utils/win32 &dagger;]		* xml2gbs – imports free-form General books in OSIS or ThML format to SWORD format [http://crosswire.org/ftpmirror/pub/sword/utils/win32 &dagger;]

	===Miscellaneous===		===Miscellaneous===