Prawn

 
 

Бързо генериране на PDF чрез библиотеката Ruby с отворен код

Безплатен Ruby PDF API, който позволява на програмистите да създават и променят PDF файлове; вмъквайте, редактирайте графики и рисувайте текст на PDF страница в Ruby Apps.

Преносимият формат на документи (PDF) е много популярен надежден и сигурен файлов формат за представяне, споделяне и отпечатване на файлове по целия свят. Библиотеката Ruby с отворен код Prawn предоставя пълна функционалност за работа с PDF документи с помощта на библиотеката Ruby. Библиотеката е много лесна за използване и добре документирана, което улеснява работата на програмиста. Той помага на разработчиците да създават изключително гъвкава система за генериране на PDF документи с лекота. 

Библиотеката Prawn включва няколко важни функции, които позволяват на разработчиците на софтуер да обработват своите PDF документи с лекота, като създаване на PDF от нулата, вграждане на PNG и JPG изображения,  добавяне на векторни рисунки  към PDF,  използване на вградени шрифтове и TrueType шрифтове, поддръжка на криптиране , защитен PDF документ с помощта на парола, поддръжка за изобразяване на текст, поддръжка на базирани на UTF-8 шрифтове, изобразяване на текст отдясно наляво, поддръжка на контури и много други.

Previous Next

Първи стъпки с Prawn

За да инсталирате Prawn на вашата система, моля, изпълнете следната команда, 

Инсталирайте Prawn чрез RubyGems

gem install prawn 

Създавайте PDF файлове чрез Ruby Library

Библиотеката Ruby с отворен код Prawn позволява на разработчиците на софтуер да създават програмно PDF документи, като използват няколко реда Ruby код. Библиотеката предоставя 3 различни начина за създаване на PDF документ с настройки по подразбиране и шрифтове. Те са чрез присвояване, скрит блок или явен блок. Веднъж създаден, можете лесно да осъществявате достъп и да променяте всяка част от вашия PDF документ. Можете лесно да добавите нова страница, да зададете размер на страницата и полета, да промените стила на шрифта, да приложите форматиране и много повече.

Създайте и изобразете PDF файл чрез Ruby


  # Using explicit block form and rendering to a file
  content = "Hello World"
  Prawn::Document.generate "example.pdf" do |pdf|
  # self here is left alone
  pdf.font "Times-Roman"
  pdf.draw_text content, :at => [200,720], :size => 32
  end
 

Вмъкване и редактиране на графики в PDF файлове

Библиотеката Prawn дава на разработчиците на софтуер силата да добавят векторни чертежи към своите PDF документи с помощта на Ruby код. Разработчиците могат лесно да рисуват линии, многоъгълници, криви, кръгове и т.н. на всяко място по свой избор в PDF страница. Библиотеката включва няколко важни функции за работа с графики, като цветове за запълване, прилагане на стилове на тире и шаблон, задаване на дебелина на линията и прилагане на цвят към нея, използване на смесен режим, прилагане на трансформация, както и прозрачност и т.н.

Използване на изображения в PDF документи

Библиотеката Ruby с отворен код Prawn предоставя поддръжка за вмъкване на изображения във вашите PDF файлове с помощта на команди Ruby. В момента библиотеката включва поддръжка за JPEG и PNG изображения. Има няколко важни функции, предоставени за управление на вашите изображения в PDF файл, като регулиране на позицията, поддръжка за мащабиране на изображението, отделно задаване на ширина и височина на изображението, пропорционално напасване на изображението и т.н.

Генерирайте изображение и мащабирайте, за да се побере в PDF чрез Ruby


  Prawn::Document.generate("image2.pdf", :page_layout => :landscape) do
   pigs = "#{Prawn::DATADIR}/images/pigs.jpg"
   image pigs, :at => [50,450], :width => 450
   dice = "#{Prawn::DATADIR}/images/dice.png"
   image dice, :at => [50, 450], :scale => 0.75
  end
 

Чертане на текст на PDF страница

Библиотеката Prawn позволява на софтуерните професионалисти да рисуват с лекота текст върху PDF страница в тяхното приложение Ruby. Можете лесно да започнете да рисувате текст върху определена позиция на PDF страница. Можете лесно да коригирате позицията на текста, да завъртите текст според вашите нужди, да приложите размер на шрифта, поддръжка на един ред и няколко реда и много повече.

Начертайте текст на PDF страница чрез Ruby Library

  
  def draw_text!(text, options)
   unless font.unicode? || font.class.hide_m17n_warning || text.ascii_only?
    warn "PDF's built-in fonts have very limited support for " \
      "internationalized text.\nIf you need full UTF-8 support, " \
      "consider using an external font instead.\n\nTo disable this " \
      "warning, add the following line to your code:\n" \
      "Prawn::Fonts::AFM.hide_m17n_warning = true\n"
    font.class.hide_m17n_warning = true
   end
   x, y = map_to_absolute(options[:at])
   add_text_content(text, x, y, options)
  end
 
 Български