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

Optional float mode for PDF boxes #658

Merged
merged 4 commits into from
Feb 17, 2021
Merged

Optional float mode for PDF boxes #658

merged 4 commits into from
Feb 17, 2021

Conversation

mih
Copy link
Collaborator

@mih mih commented Feb 17, 2021

By default all boxes are included at the location the appear in the
text. Optionally, (large) boxes be turned into float, like this:

.. windowsworkarounds:: For Windows users only
   :float: p

where p is an (optional) positioning argument (the usual LaTex kind,
i.e. could also be something like tbp). If the position label is not
given (i.e. just :float:) LaTex will do its default thing.

Floating boxes likely will need to be referenced in the text, hence
should also come with a name attribute:

.. windowsworkarounds:: For Windows users only
   :name: funky
   :float: p

This change has no implications for the HTML output.

and introduce additional options for all toggles.
By default all boxes are included at the location the appear in the
text. Optionally, (large) boxes be turned into float, like this:

```rst
.. windowsworkarounds:: For Windows users only
   :float: p
```

where `p` is an (optional) positioning argument (the usual LaTex kind,
i.e. could also be something like `tbp`). If the position label is not
given (i.e. just `:float:`) LaTex will do its default thing.

Floating boxes likely will need to be referenced in the text, hence
should also come with a `name` attribute:

```rst
.. windowsworkarounds:: For Windows users only
   :name: funky
   :float: p
```

This change has no implications for the HTML output.
@adswa
Copy link
Contributor

adswa commented Feb 17, 2021

That's cool! I will transform very long findoutmore's or those with less relevance to the text into floats.

@adswa adswa merged commit 06fe3c4 into master Feb 17, 2021
@adswa adswa deleted the floatbox branch February 17, 2021 07:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants