Skip to content

This is not the official repo for Bloom Desktop! It is intended only to contain my personal pull requests. Bloom Desktop is a hybrid c#/javascript/html/css Windows application that dramatically "lowers the bar" for language communities who want books in their own languages. Bloom delivers a low-training, high-output system where mother tongue sp…

License

Notifications You must be signed in to change notification settings

JohnThomson/BloomDesktop

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Let's Grow Some Libraries

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.

Development Process

Kanban / Bug Reports

We use YouTrack Kanban boards. Errors (via email or api) also flow into YouTrack, and we do some support from there by @mentioning users.

Continuous Build System

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.

Building Browser Source Code

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

Building C# Source Code

To build the .NET/C# part of Bloom you'll need Visual Studio Community Edition.

Setting up c# formatting

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

Get Binary Dependencies

Before you'll be able to build, you'll have to download some binary dependencies (see below).

TeamCity artifacts

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.

NuGet packages

Various NuGet packages should get pulled in by the build automatically.

Our Palaso libraries hold the classes that are common to multiple products.

Adding npm dependencies

npm dependencies should be introduced using

yarn add <modulename>

Linux Development

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.

Disable analytics

We don't want developer and tester runs (and crashes) polluting our statistics. On Windows, add the environment variable "feedback" with value "off".

Registry settings

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.

License

Bloom is open source, using the MIT License. It is Copyright SIL International. "Bloom" is a registered trademark of SIL International.

About

This is not the official repo for Bloom Desktop! It is intended only to contain my personal pull requests. Bloom Desktop is a hybrid c#/javascript/html/css Windows application that dramatically "lowers the bar" for language communities who want books in their own languages. Bloom delivers a low-training, high-output system where mother tongue sp…

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C# 52.8%
  • JavaScript 18.6%
  • TypeScript 13.1%
  • HTML 8.3%
  • CSS 6.1%
  • Shell 1.0%
  • Other 0.1%