Start by downloading and installing Wicked PDF's precompiled binary. Here we'll install the required gems:. Our demo application will only have two models: Invoice and InvoiceItem.
To create the Invoice model, navigate to the root of your project from the command line and type:. The show action has 2 formats html and pdf , which will be used to define how the content is rendered. For example, if you access the invoice directly without the. Try it here:. You can configure the options however you need see wkhtmltopdf documentation for additional details. To customize the layout of the PDF, use the following settings:.
For this example, I will only use the stylesheet helper:. Now you need to make sure all the assets will are precompiled according to the official GitHub, this next step is essential for your gem to work perfectly when you deploy to production :. The above array will need to include every stylesheet and JavaScript library that you're using.
You can now deploy your application for generating PDFs. Here's our demo application that we deployed to a free Heroku web dyno. Using wkhtmltopdf is a quick and easy way to generate PDFs from Ruby. However, if you need to generate PDFs from something other than HTML, want to integrate this into a workflow, or need precise control over positioning, then you're out of luck with wkhtmltopdf. These engines are best suited for simple documents where you can afford to have some inconsistencies or failures.
If you go this route, using Bundler is encouraged. If the following code runs and produces a working PDF file, you've successfully installed Prawn. Felipe Doria provided us with a beautiful system for generating a user manual from our examples. Note that while we will try to keep the downloadable manual up to date, that it's provided as a convenience only and you should generate the manual yourself if you want to be sure the code in it actually runs and works as expected.
To build the manual, here's what you need to do:. Before upgrading Prawn on one of your projects, you should read our API compatibility guidelines. Generally speaking, you can expect tiny and minor version updates to always be safe upgrades, but major updates can introduce incompatibilities. Feel free to post any Prawn related question there, our community is very responsive and will be happy to help you figure out how to use Prawn, or help you determine whether it's the right tool for the task you are working on.
Please make your posts to the list as specific as possible, including code samples and output where relevant.
Do not post any information that should not be shared publicly, and be sure to reduce your example code as much as possible so that those who are responding to your question can more easily see what the issue might be. Prawn adheres to the Contributor Covenant. Unacceptable behavior can be reported to conduct prawnpdf. If you've found a bug or want to submit a patch, please enter a ticket into our GitHub tracker. We strongly encourage bug reports to come with failing tests or at least a reduced example that demonstrates the problem.
Similarly, patches should include tests, API documentation, and an update to the manual where relevant. Feel free to send a pull request early though, if you just want some feedback or a code review before preparing your code to be merged. If you are unsure about whether or not you've found a bug, or want to check to see whether we'd be interested in the feature you want to add before you start working on it, feel free to post to our mailing list.
These filters make it possible for us to add failing test cases for bugs that are currently being researched or worked on, without breaking the typical full suite run. Prawn has always been heavily dependent on community contributions, with dozens of people contributing code over the year.
In that sense, the lines have blurred to the point where we no longer have a strong distinction between core developers and contributors. That said, there are a few folks who have been responsible for cutting releases, merging important pull requests, and making major decisions about the overall direction of the project.
These folks have helped out in a maintenance role in the past, but are no longer actively involved in the project:. If you contribute to Prawn, you will retain your own copyright but must agree to license your code under the same terms as the project itself. Prawn was originally developed by Gregory Brown , under the auspices of the Ruby Mendicant Project, a grassroots initiative in which the Ruby community collectively provided funding so that Gregory could take several months off from work to focus on this project.
Over the last several years, we've received code contributions from dozens of people, which is amazing considering the low-level nature of this project. You can find the full list of folks who have at least one patch accepted to Prawn on GitHub Contributors page. After a long period of inactivity, Prawn reached its 1.
Brad Ediger's company. Skip to content. Star 4. View license. C Ractor::IsolationError. C Ractor::MovedError. C Ractor::MovedObject. C Ractor::RemoteError. C Ractor::UnsafeError. M Random::Formatter. C SecurityError. C SignalException. C StandardError. C StopIteration. C SystemCallError. C SystemStackError. C Thread::Backtrace. C Thread::Backtrace::Location. C Thread::ConditionVariable. C Thread::Mutex. C Thread::Queue. C Thread::SizedQueue. C UnboundMethod. C UncaughtThrowError. M UnicodeNormalize.
C ZeroDivisionError. Complex Kernel. Integer Kernel. Rational Kernel. Home Core 3. Ruby 3. File :: blocking?
Dir :: empty? ENV :: empty? GC::Profiler :: enabled? File :: exist? Dir :: exist? File :: exit Process :: exit Thread :: exit! File :: filter ENV :: filter! ENV :: find Encoding :: fnmatch File :: fnmatch? ENV :: home Dir :: hypot Math :: identical? ENV :: members Struct :: merge! Thread :: pid Process :: pipe IO :: pipe?
File :: shareable? File :: slice ENV :: socket? File :: writable? File :: write IO :: yield Fiber :: yield Ractor :: zero? Fiber alive? Thread all? Array all? Enumerable allbits? Array any? Enumerable any? Hash anybits? IO autoload Kernel autoload Module autoload?
Kernel autoload? ARGF binmode? Kernel blockdev? File::Stat blockdev? FileTest blocking? String captures MatchData casecmp String casecmp Symbol casecmp? String casecmp? Symbol casefold? File::Stat chardev?
String chop Kernel chop String chop! ARGF closed? IO closed? Array compact! File::Stat directory? Time dummy? Array empty?
0コメント