Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Build a repository of braille CSS style sheets #749

Open
bertfrees opened this issue Dec 7, 2023 · 0 comments
Open

Build a repository of braille CSS style sheets #749

bertfrees opened this issue Dec 7, 2023 · 0 comments

Comments

@bertfrees
Copy link
Member

bertfrees commented Dec 7, 2023

Pipeline doesn't have any braille formatting defaults. Braille transcription is not an issue, as we rely on the Liblouis library, which supports many languages (thanks to its wide use and large community). But braille formatting is done in Pipeline itself based on CSS, and we currently don't provide style sheets for the whole world. Note that there is no global braille formatting standard.

We don't have the ambition nor the resources to look up all the different braille formatting standards that exist and implement a style sheet for each of them ourselves. But on the other hand, having good defaults is crucial for the usability of Pipeline. So we need help from the DAISY community to build a repository of style sheets.

First, we should have a place that people can find easily and make it easy to contribute stuff. We probably need a few good examples of style sheets to start with. Perhaps a kind of template could be useful too. And a kind of tutorial-style document for creating a braille style sheet. Note that we have the braille CSS reference documentation, but this is not very suited as guidance.

The ebraille initiative should be mentioned also. Since it also relies on CSS for braille formatting, it has a very similar challenge. So this can become a combined effort.

As for the level of sophistication of submitted style sheets: I think it's important to accept anything from basic style sheets to comprehensive ones. Whatever is in the repository can be built on and improved by others. Anything that is too specific to an organisation's content or workflow (such as non-standard classes for instance) should be automatically filtered out with some tool, so that this is not the job of the contributor.

Note also that Pipeline supports Sass, a superset of CSS which can have parameters that the user can set via the Pipeline user interface, but we should not have any requirements regarding parameters that a style sheet should have. Instead, we should make the user interface adapt to the parameters that have been defined in a given style sheet.

@bertfrees bertfrees converted this from a draft issue Dec 7, 2023
@bertfrees bertfrees changed the title Simplification of configuration of braille production scripts Build a repository of braille CSS style sheets Dec 8, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
No open projects
Development

No branches or pull requests

1 participant