Preparing language data for publication
HTML CSS C# TeX AutoIt XSLT Other
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
Build
DistFiles
Installer
InstallerXeLaTeX
debian
lib
packages
src
.editorconfig
.gitattributes
.gitignore
GlobalAssemblyInfo.cs
LICENSE.md
Makefile
Makefile40
Makefile46
Pathway.sln
Pathway4.sln
Pathway46.sln
ProjectFiles.xpr
README.md
buildTest.sh

README.md

Pathway

Preparing language data for publication

http://pathway.sil.org

Pathway prepares dictionary and Scripture data in open document (odf), e-book (epub 2.0), portable document (pdf), TeX and J2ME (jar) formats. Print and electronic publications can be distributed on web sites, Android cell phones, and Java feature phones. Indirectly Pathway can be used for doc, docx, Kindle®, and Nook®. The epub format will also work on tablets using software for reading e-books.

Pathway installs as an add-on of SIL FieldWorks and Paratext, or it can be launched in batch process.

Old stable release

License

Pathway is licensed under GNU GENERAL PUBLIC LICENSE. See LICENSE.md

Documentation

Major Features

Learning Pathway

Wiki

User submitted

Binaries

Binary builds.

Source Code

Source Code Repository

Issue Tracking

Issue Tracking

Submit a request

Development

Pathway is currently running under .net 4.0.

Before building Pathway

Before building Pathway, the developer should install the latest dependencies. This is done with Build/getDependencies.sh This command runs a bash script. (On Windows, make sure you have git installed and run from the bash window.) This will go to Team City and download the tagged dependencies from libpalaso and put it in the lib folder. It is very important when building the Windows version to have the Configuration Manager Active solution platform set to x86. If this is not done, a dependency error will be reported when trying to run the localization code even though the build will succeed without error.

Building on Windows

On Windows Pathway is built with Visual Studio. The Debug Configuration is used for building while doing development. The Platform should be set to x86. Unit tests and some scenario tests are contained in the Test project. Some tests are marked with SkipOnTeamCity so they won't run on the build server. Also some tests are marked with LongTest since they take more than 3 seconds to complete. The folder structure of the Test project mirrors the folder structure of pathway.

Other configurations are used to prepare package for the various releases. The BTE packages are for FieldWorks BTE and can be used with Paratext as well. The SE packages work with FieldWorks SE versions. The Corporate release packages are intended for stable releases whereas the Release packages also include back ends that are still in development and testing. The Installer project depends on all the others so that it will build last. In the BeforeBuild target in the .csproj file for the Installer project, copies the outputs of other Visual Studio projects to a single folder so they can be packaged by Wix from there. (The Test project also has a BeforeBuild copy process to set up a folder with everything needed for testing.)

Pathway is structured so that additional Back ends can be added for other output formats. The interface for each back end is somewhat simple but allows the Pathway program to get the name of the back end for the drop down and then pass control to the Export method in the back end if the user has selected it.

The user interface elements are kept in the CssDialog project. The BuildTasks project contains some C# methods called during the windows packaging process.

Building on Linux

Building on Linux. The command:

./buildTest.sh

will download the NuGet packages and build Pathway. Once the NuGet packages are in place, the Makefile in the pathway folder is used for development on Linux so:

make debug

will build the Debug build and

./nunit-mono4-sil.sh

will run the unit tests. As you can see Pathway requires mono4-sil to be installed to have access to the latest patched version of mono.

NB: Pathway can also be built with mono-sil and one of the build processes does this for Paratext and FieldWorks versions that are not using the latest mono4-sil yet.