search

jhpyle / docassemble

A free, open-source expert system for guided interviews and document assembly, based on Python, YAML, and Markdown.
https://docassemble.org
MIT License
796 stars 258 forks source link

Document styles / css classes needed to apply custom styles for Docassemble #39

Closed nonprofittechy closed 6 years ago

nonprofittechy commented 7 years ago

Possible #hacktoberfest?

It would be nice to have a list of the items that you should style if you want a custom look for your Docassemble interview. Trying to interest someone at GBLS in documenting this

jhpyle commented 7 years ago

Note that docassemble is based on Bootstrap, so a "custom look" can be achieved through Bootstrap themes such as those available at Bootswatch or WrapBootstrap.

In 0.1.72 I added an feature and configuration directive called bootstrap theme that can be used to easily substitute one of these themes.

You can override Bootstrap CSS with your own CSS classes, but you often have to write a lot of CSS in order to do so. So, if you want a custom look, the easiest thing to do is probably to create your own Bootstrap theme, or make modifications to an existing one, and use the Less pre-processor to make global changes to things like colors.

After you have the "theme" you want, you can tweak the appearance of things in docassemble by overriding the CSS classes that docassemble uses in the docassemble_webapp/docassemble/webapp/static/app/app.css file.

leonhatori commented 6 years ago

any plans to implement another bootstrap framework?

jhpyle commented 6 years ago

I plan to migrate from Bootstrap 3.0 to Bootstrap 4.0, but other than that, no. However, I may not understand exactly what you are asking.

jhpyle commented 6 years ago

The migration from Bootstrap 3.0 to Bootstrap 4.0 is effective in version 0.2.50.

jhpyle commented 6 years ago

Someone can re-open this issue if there is something specific that can be changed, but the current design is to rely wholly on Bootstrap theming, which is documented on Bootstrap-related sites already. There are a couple of docassemble-specific CSS customizations that add to Bootstrap, and these are mentioned in the documentation already.

nonprofittechy commented 6 years ago

This seems good--sorry, I should have closed it earlier after your first response about Bootstrap. I think that meets our needs.