TL;DR
Get art and craft supplies delivered free with Prime
- Fast, free delivery on millions of items
- Prime Video, Amazon Music and more included
- Member-only deals all year
Florilegium is a GitHub project for generating decorative page margins in LaTeX. It uses Lua to draw flowers and other motifs directly into PDFs, with randomized layouts, optional text-responsive features and alternative visual themes. The project author says it is one way to create a similar look to an image discussed on Reddit, not a reproduction of the original.
A GitHub project called Florilegium generates floral page margins for LaTeX documents by drawing each petal, leaf and stem with Lua code as the PDF is produced. Its author describes it as one possible response to a Reddit question about making a similar-looking design, while stressing that the project does not attempt to reproduce the unknown original.
The package creates a Delft-blue garden from parametric curves and randomized drawing parameters. It uses no imported images, external assets or imported paths: the shapes are calculated in Lua and written into the PDF. The author says each page receives its own composition, with the random seed determining the arrangement.
The project provides two main approaches. In the hand-authored version, stems, leaves and flowers are placed by the author, while their parameters are sampled. In the “grown” version, a greedy space-filling loop adds plants to available areas. The report says this layout is tuned for A4 pages with a 68 mm margin, rather than adapting to arbitrary page layouts. It can use open space below the text on a final page when the text ends early.
The repository also includes an animation showing one seed develop from an empty margin to a finished composition. According to the project description, stems appear first, followed by leaves and flowers; the layout then fills larger open areas before smaller ones. The animation records the drawing process and replays pieces in their original painting order. The author says the supplied grow-6 render takes about 45 seconds.
Decorative Margins Without Image Files
Florilegium offers LaTeX users a way to add complex page decoration without preparing or embedding a separate illustration for every page. Because the marks are generated during PDF creation, the design can vary by page while remaining part of the document’s output. That may appeal to people producing illustrated reports, books or other documents where a consistent visual system matters.
Some features connect the decoration to document content. A command can turn a paragraph’s initial letter into a painted motif, while another can place a flower beside a chosen line. An optional section feature adds flowers beside numbered headings. These functions make the project more than a static border generator, although the report does not provide performance benchmarks, compatibility results across LaTeX setups or user testing.
The project also separates its layout process from how motifs are drawn. Its author says the growth loop consults a table of motifs and their space requirements, while themes can replace drawing primitives or add motifs. That design allows a different visual treatment to use the same placement method, as shown by the geometric theme.
Popular right now
TCL T7 Series 85-Inch 4K 144Hz QLED Smart Google TV
Bose QuietComfort Wireless Noise Cancelling Headphones, Sandstone
Shark PowerDetect Corded Stick Vacuum, Self-Cleaning (Eggplant, HZ4002)
As an affiliate, we earn on qualifying purchases.
From Reddit Prompt to Package
The project author traces Florilegium to a Reddit post asking how to make flowers of a particular appearance in LaTeX. The original image’s method was unknown to the author, who says the repository is not a reconstruction. The GitHub report presents the work instead as a custom implementation using hand-authored drawing primitives, randomized parameters and a procedural layout.
The repository describes several documents that demonstrate the package. One uses a composition arranged by hand; another grows a design to fit the page. Showcase documents demonstrate additional features and visual styles. The report says the example PDFs explain how their margins are drawn, so the documents double as demonstrations of the project.
Alongside the floral treatment, the project lists a geometric theme made from flat shapes, including polygonal leaves, rosette-like flowers and crystal forms. A separate math theme replaces the plant imagery with mathematical figures arranged down the margin and across the bottom of the page. These examples show the project’s stated theme mechanism, but the supplied report does not give complete technical or installation details.
“It is one possible way, and the way I did it.”
— Florilegium project author, in the GitHub report
Compatibility and Layout Limits
The supplied report does not state when the project was released or provide independent testing of the package. It is also unclear which LaTeX engines and software versions are supported, how installation works, or whether the package has been tested with documents beyond the examples in the repository.
The author says the grown layout is tuned for A4 paper and a 68 mm margin and “adapts to nothing.” The report does not explain how reliably the design behaves with other page sizes, margin widths, fonts or complex page layouts. It also says the aging feature needs two runs to determine page count, but provides no broader account of build time for complete documents.
The described Reddit image’s creator and production method are not identified in the source. Florilegium’s author explicitly says the project does not try to reproduce it, so similarity should not be read as evidence of shared design or technique.
Further Testing and Project Use
The GitHub repository is the available source for the code, demonstration documents and generated previews described in the report. The next practical step for interested LaTeX users is to review the repository’s installation instructions and test the package with their own engine, page dimensions and document structure. The supplied material does not announce a release schedule, roadmap or planned feature update.
Further project documentation could clarify engine compatibility, configuration outside the demonstrated A4 layout and the cost of compiling longer documents. Until such information is available, the examples establish what the author has built, but not how broadly it has been tested or how it performs in other publishing workflows.
Key Questions
What is Florilegium?
Florilegium is a GitHub project that uses Lua to generate decorative page margins in LaTeX PDFs. Its main demonstration creates randomized floral compositions.
Does it use imported flower images?
No. The project report says petals, leaves and stems are calculated from parametric curves and drawn directly into the PDF, without imported images, paths or external assets.
Does Florilegium reproduce the Reddit image that inspired it?
No. The author says the original image’s production method is unknown and describes Florilegium as one possible way to create a similar look, not an attempt to reproduce the original.
Can the design respond to document text?
The report describes commands for decorated paragraph initials and flowers beside selected lines, plus an option to place flowers beside numbered section headings. It also describes an aging effect that changes the garden across pages and requires two runs to determine the page count.
Is it known to work with every LaTeX layout?
No. The author says the grown layout is tuned for A4 pages with a 68 mm margin and does not adapt to other layouts. The supplied report does not list tested engines or broader compatibility results.
Source: github.com
