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

Breaking changes #6

Merged
merged 9 commits into from
Feb 4, 2023
Merged

Breaking changes #6

merged 9 commits into from
Feb 4, 2023

Conversation

Omikhleia
Copy link
Owner

@Omikhleia Omikhleia commented Feb 1, 2023

Things that change the output document:

  • Visual change to captioned figures
  • Default footnote styling change

Things that have deeper breaking aspects

  • Class hierarchy refactors
  • Hacks for killing multiple package instantiation, 'cause this breaks severely my use cases since August.

Also update the dev rockspec to load all our module as dependencies. There are needed in the manual, and there's no point for me not to have them. The only interest to have them as separate modules is that some people may want to use them without the rest of the resilient stuff, but heh.

The defaults for captioned figure styles weren't really though of,
and were different from captioned tables "just" for checking
which was applied. In a real book, one expects more homogeneity
by default.
So packages inherit the styles mechanism without having to
repeat the same code again and again.

Breaking as it impacts how certain things are loaded
in those classes, and when... And standard 'autodoc' breaks
at generating the package documentation.
So our classes inherit the styles mechanism without having to
repeat the same code again and again.
That's a departure from SILE 0.14 with dirty hacks and a very
opinionated breaking change. See in-code comments.
It also introduces 'autodoc-resilient' as standard 'autodoc',
besides the same opinionated changes, cannot work any longer
with resilient classes and packages, as 'partial' loading of
packages won't get the styles due to previous refactors.
@Omikhleia Omikhleia self-assigned this Feb 4, 2023
@Omikhleia Omikhleia added bug Something isn't working documentation Improvements or additions to documentation enhancement New feature or request labels Feb 4, 2023
@Omikhleia Omikhleia added this to the 2.0 milestone Feb 4, 2023
Stop being too cautious, we want them all in "resilient".
@Omikhleia Omikhleia merged commit d90153b into main Feb 4, 2023
@Omikhleia Omikhleia deleted the breaking-changes branch February 6, 2023 01:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
bug Something isn't working documentation Improvements or additions to documentation enhancement New feature or request
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

1 participant