Bloom is an award winning software solution to the children's book shortage among most of the world's languages. It is an application for Windows and Linux that dramatically "lowers the bar" for creating, translating, and sharing books. With Bloom, communities can do the work for themselves instead of depending on outsiders.
Internally, Bloom is a hybrid. It started as a C#/WinForms app with an embedded browser for editing documents and an embedded Adobe Acrobat for displaying PDF outputs. It is growing up to be a pure React-driven offline-capable web app, with a C# backend. In its current state, Bloom is hybrid of C#/web app in which the bits of the UI are gradually moving to html.
We use YouTrack Kanban boards. Errors (via email or api) also flow into YouTrack, and we do some support from there by @mentioning users.
Each time code is checked in, an automatic build begins on our TeamCity build server, running all the unit tests. Similarly, when there is a new version of some Bloom dependency (e.g. bloom-player
), that server automatically rebuilds and publishes Bloom Alpha. Public channels are released by pressing a button on the TeamCity page. This "publish" process builds Bloom, runs tests, makes an installer, uploads it to S3, and writes out a little bit of json which the Bloom download page uses to display version-specific information to the user.
You'll need nodejs and yarn, but we manage both by installing volta and informing volta which versions to use with a setting in package.json:
"volta": {
"node": "16.14.0",
"yarn": "1.22.19"
}
This will build and test the Typescript, javascript, less, and pug:
cd src/content
yarn
cd ../BloomBrowserUI
yarn
yarn build
yarn test
To watch code, use yarn watchCode
To build the .NET/C# part of Bloom you'll need Visual Studio Community Edition.
In a terminal, run dotnet tool restore
. This will install any tools we have put in .config/dotnet-tools.json along with the correct versions.
In Visual Studio, under Extensions, install "CSharpier".
In Preferences, under CSharpier:Solution, set Reformat with CSharpier on Save
to true
. Note that you are setting it for this solution, not in general.
You should also install the CSharpier extension in vscode.
When testing a new version of csharpier, to format everything, run dotnet csharpier src/BloomExe
To hide reformatting-only commits from git blame, add the sha of the commit to .git-blame-ignore-revs
Before you'll be able to build, you'll have to download some binary dependencies (see below).
In the build
directory, open a git bash shell and run
./getDependencies-windows.sh
That could take several minutes the first time, and afterward will be quick as it only downloads what has changed. When you change branches, run this again.
Our PdfDroplet engine drives the booklet-making in the Publish tab. If you need to build PdfDroplet from source, see the project on Github.
Various NuGet packages should get pulled in by the build automatically.
Our Palaso libraries hold the classes that are common to multiple products.
npm dependencies should be introduced using
yarn add <modulename>
5.4 is the last version for Linux until we get rid of WinForms.
See the Version5.4
branch and ReadMe if you need to update it.
See this page for how to run it.
We don't want developer and tester runs (and crashes) polluting our statistics. On Windows, add the environment variable "feedback" with value "off".
One responsibility of Bloom desktop is to handle url's starting with "bloom://"", such as those used on bloomlibrary.org when the user clicks "Translate into your language!" Making this work requires some registry settings. These are automatically created when you run Bloom. If you have multiple versions installed, just make sure that the one you ran most recently is the one you want to do the download.
Bloom is open source, using the MIT License. It is Copyright SIL International. "Bloom" is a registered trademark of SIL International.