|
4 | 4 | 
|
5 | 5 | 
|
6 | 6 |
|
7 |
| -#### ⭐ Support us, be cool, [star this repository on GitHub](https://github.com/bastibense/libharu_ng)! :) |
| 7 | +#### ⭐ Support this crate, be cool, [star this repository on GitHub](https://github.com/bastibense/libharu_ng)! :) |
8 | 8 |
|
9 | 9 | ## What is it?
|
10 | 10 |
|
@@ -87,32 +87,20 @@ fn main() -> Result<(), HaruError> {
|
87 | 87 | }
|
88 | 88 | ```
|
89 | 89 |
|
90 |
| -# Motivation & Alternatives |
| 90 | +# Motivation |
91 | 91 |
|
92 | 92 | The main motivation behind `libharu_ng` is to provide a simple and modern API for generating PDFs from Rust code.
|
93 | 93 |
|
94 | 94 | One of the requirements was fine-grained control over the content of the PDF document and minimal dependencies and size/performance overhead.
|
95 | 95 |
|
96 | 96 | There are a number of alternatives for generating PDFs from Rust code, each with their own advantages and disadvantages:
|
97 | 97 |
|
98 |
| -- **lopdf** - [Crate](https://crates.io/crates/lopdf) - A pure Rust library for very low-level PDF manipulation. |
99 |
| - - **printpdf** - [Crate](https://crates.io/crates/printpdf) - A "higher" level API for generating PDFs, based on `lopdf`. |
100 |
| -- **wkhtmltopdf** - [Crate](https://crates.io/crates/wkhtmltopdf) - A wrapper for the `wkhtmltopdf` command line tool - which is deprecated. |
101 |
| -- Using a headless browser like Chromium. This will require a _lot_ of RAM - possibly more than your server has available, especially if you want to generate multiple PDFs in parallel. |
102 |
| -- ... |
103 |
| - |
104 |
| -This is not a complete list, but it should give you an idea of the alternatives. Of course there are commercial solutions as well, but for many use cases, they are not an option, overkill, require extensive integration or are too expensive. |
105 |
| - |
106 | 98 | This crate, as is, will try to compile the `libharu` library from source, embedding it into your Rust project. This means that you don't have to install any additional dependencies on your system, and you don't have to worry about the `libharu` version on your system. If you have problems with the embedded `libharu` version, please open an issue.
|
107 | 99 |
|
108 | 100 | # Contributing
|
109 | 101 |
|
110 | 102 | Contributions are welcome. Please open an issue before submitting a pull request.
|
111 | 103 |
|
112 |
| -If you want to contribute, please make sure that your code is formatted using `rustfmt` and that it compiles without warnings. |
113 |
| - |
114 |
| -Please refer to the issue tracker for ideas on what to contribute. |
115 |
| - |
116 | 104 | # License
|
117 | 105 |
|
118 | 106 | - This project is licensed under the MIT license.
|
|
0 commit comments