Feature/custom page size

[sanderai]

Description
Adds a new method for creating documents with custom page dimensions. Previous shorthand is preserved and uses the new method internally to avoid duplicate code.

Related Issue
resolves #148

Checklist

check with "x", if applied to your change

• All methods associated with structs has func (s *struct) method() {} name style.
• Wrote unit tests for new/changed features.
• Updated docs/doc.go - docs file seems to not include all methods? didn't change this so maybe original developer can update this if necessary.
• Updated pkg/pdf/example_test.go
• Updated README.md - Mentioned the new method but not linked to godoc
• Updated all examples inside internal/examples
• New public methods/structs/interfaces has comments upside them explaining they responsibilities
• Executed go fmt github.com/johnfercher/maroto/... to format all files

[codecov-commenter]

Codecov Report

Merging #149 into master will increase coverage by 0.12%.
The diff coverage is 100.00%.

@@            Coverage Diff             @@
##           master     #149      +/-   ##
==========================================
+ Coverage   96.24%   96.36%   +0.12%     
==========================================
  Files           9        9              
  Lines         584      603      +19     
==========================================
+ Hits          562      581      +19     
  Misses         16       16              
  Partials        6        6              

Impacted Files	Coverage Δ
pkg/pdf/pdf.go	100.00% <100.00%> (ø)

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 9add775...7717496. Read the comment docs.

[johnferchermeli]

Strange that the width and height parameters invert when set the landspace orientation. Is this correct?

[sanderai]

Strange that the width and height parameters invert when set the landspace orientation. Is this correct?

Yeah this seems to be the way gofpdf.NewCustom() works. I think the "default" orientation is Portrait and you give the width and height of that. And then when you turn it to landscape, it flips those numbers (as seen in their source).
They also use just the portrait dimensions for defining their own preset sizes as seen here (they use the "points" unit for dimensions which is why they look odd)

So yes, this is the correct behavior as page dimensions are usually given in portrait orientation. You could theoretically use Portrait input and give a wider width than height and have a "landscape" page that way, but that would be cheating a bit.