Skip to content

Fix the layout on the guide templates #2133

@sydseter

Description

@sydseter

NB: Please wait for this to be merged: #2111

Describe the bug
The template for the guide document doesn't work with the new text and need to be adjusted in order to look good. see:

owasp_cornucopia_webapp_2.2_guide_bridge_en.docx

owasp_cornucopia_webapp_2.2_guide_bridge_en.pdf

From the base of the repo you run the following:

python -m pipenv install --dev
python -m pipenv run python .\scripts\convert.py -v 2.2 -l en -t bridge -e webapp -lt guide --pdf

python -m pipenv run python .\scripts\convert.py -v 2.2 -l en -t bridge_qr -e webapp -lt guide --pdf
# If it doesn't work see: https://github.com/owasp/cornucopia/blob/master/scripts/README.md#contributing-to-development

This should create two pdf document. Go back to the odt guide templates found here : https://github.com/OWASP/cornucopia/tree/master/resources/templates

Adjust until they look good. NB: You need to make sure that it works with all the translations: "en", "es", "fr", "nl", "no-nb", "pt-br", "pt-pt", "it", "ru", "hu"

This means that there will be quite a lot of whitespace between the main chapters. The main thing is to make sure that the two colums align so that it's easy to read. A new section should always start at the top of the page and not like how it does here:

Image

In addtion, the guide documents comes with cards that can be printed out on a desktop printer, if it supports printing front and back at the same time, but in order to make this easier the backside should follow after each sheet in the guide with cards so that they naturally can be printed front and back. Currently, this is not the case.

After each of the front sides:

Image

You should have a back side:

Image

Metadata

Metadata

Assignees

Labels

bugSomething isn't workingconverterhelp wantedExtra attention is neededpythonPull requests that update Python code

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions