serenity - GitLite

KO | EN

gitlite — search

#hacktoberfest #ai #typescript #go #linux #docker #macos #nodejs #awesome #cli #awesome-list #pytorch #mcp #open-source

serenity

(★ 95)

Embedded ruby for Open Office documents. You provide .odt template and data and Serenity generates the document. Great for creating dynamic reports.

파일 탐색기

최종 버전 다운로드 (.zip)

- convert_benchmark.rb
- advanced.odt
- footer.odt
- greek.odt
- header.odt
- loop.odt
- loop_table.odt
- meta.odt
- table_rows.odt
- variables.odt
- - debug.rb
  - escape_xml.rb
  - generator.rb
  - images_processor.rb
  - line.rb
  - node_type.rb
  - odteruby.rb
  - template.rb
  - xml_reader.rb
- serenity.rb
- serenity-odt-0.1.0.gem
- serenity-odt-0.1.1.gem
- serenity-odt-0.2.0.gem
- serenity-odt-0.2.2.gem
- - charts_output.png
  - serenity_output.png
  - serenity_template.png
- charts_showcase.odt
- charts_showcase.rb
- charts_showcase_output.odt
- showcase.odt
- showcase.rb
- showcase_output.odt
- escape_xml_spec.rb
- generator_spec.rb
- odteruby_spec.rb
- output_greek.odt
- spec_helper.rb
- template_spec.rb
- xml_reader_spec.rb
.gitignore
Changelog
LICENSE
Rakefile
README.md
serenity-odt.gemspec

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/kremso/serenity

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd serenity

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. 공식 설치 스크립트

쉬움 추천

사전 준비물

Ruby gem 명령어를 쓰려면 Ruby가 필요합니다.

gem install serenity-odt

RubyGems에 배포된 패키지를 바로 설치합니다.

✅ 설치 후 새 터미널을 열고, 프로그램의 버전 확인 명령(예: --version)으로 정상 설치됐는지 확인하세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

Serenity is an embedded ruby for OpenOffice documents (.odt files). You provide an .odt template with ruby code inside a special markup and the data and Serenity generates the document. If you know erb all of this should sound familiar.

Important Changes
=================

As of version 0.2.0 serenity is using instance variables in the templates. In previous versions, your instance variables would be converted to local before passing to the template, so while in the code you had `@title = 'Serenity'`, you had to put `{%= title }` in the template to get serenity to work. This has now changed and you need to use instance variables in the templates: `{%= @title }`. Honestly, I don't know why I did it this way in the first place, considering that people are used to instance variables in templates from rails.

What's new
==========

**0.4.0** &mdash; `meta.xml` is now processed too. You can put template markup in
the document metadata (for example a templated `dc:title`) and it will be filled
in just like the body. So a document whose title is `{%= @title %}` will end up
with the title you pass in.

**0.3.0** &mdash; embedded objects (such as charts) placed inside a loop are now
duplicated once per iteration. If you drop a chart inside a `{% for %}` loop,
each iteration gets its own copy of that object, evaluated against that
iteration's data &mdash; so every row of your loop can carry its own chart. The
object references are rewritten to unique `Object N` directories and the
`META-INF/manifest.xml` is updated automatically. See
[showcase/charts_showcase.rb](showcase/charts_showcase.rb) for a runnable
example that gives every crew member their own chart:

![Charts output](https://raw.githubusercontent.com/kremso/serenity/master/showcase/imgs/charts_output.png)

0.3.0 also fixes a `FrozenError` that could be raised on Ruby 2.7+ when the data
being escaped was a frozen string.

Usage
======

Serenity is best demonstrated with an example. The first picture shows the template with the ruby code, next image shows the generated document. The template, output and the sample script can be found in the showcase directory.

![Serenity template](http://github.com/kremso/serenity/blob/master/showcase/imgs/serenity_template.png?raw=true)

The image above is a screenshot of showcase.odt from the [showcase](http://github.com/kremso/serenity/blob/master/showcase) directory. It's a regular OpenOffice document with ruby code embedded inside a special markup. That ruby code drives the document creation. You can use conditionals, loops, blocks &mdash; in fact, the whole ruby language and you can apply any OpenOffice formatting to the outputted variables or static text.

The second line in the template is `{%= @title%}` what means: output the value of variable title. It's bold and big, in fact, it's has the 'Heading 1' style applied. That variable will be replaced in the generated document, but it will still be a 'Heading 1'.

You can now take that template, provide the data and generate the final document:

require 'rubygems'
    require 'serenity'

class Showcase
      include Serenity::Generator

Person = Struct.new(:name, :items)
      Item = Struct.new(:name, :usage)

def generate_showcase
        @title = 'Serenity inventory'

mals_items = [Item.new('Moses Brothers Self-Defense Engine Frontier Model B', 'Lock and load')]
        mal = Person.new('Malcolm Reynolds', mals_items)

jaynes_items = [Item.new('Vera', 'Callahan full-bore auto-lock with a customized trigger, double cartridge and thorough gauge'),
                        Item.new('Lux', 'Ratatata'),
                        Item.new('Knife', 'Cut-throat')]
        jayne = Person.new('Jayne Cobb', jaynes_items)

@crew = [mal, jayne]

render_odt 'showcase.odt'
      end
    end

The key parts are `include Serenity::Generator` and `render_odt`. The data for the template must be provided as instance variables.

Following picture shows the generated document. It's a screenshot of the showcase_output.odt document from the [showcase](http://github.com/kremso/serenity/blob/master/showcase) directory.

![Generated document](http://github.com/kremso/serenity/blob/master/showcase/imgs/serenity_output.png?raw=true)

Installation
============

gem install serenity-odt

Yeah, serenity is already taken on gemcutter.

Creating templates
===================

Templates are created directly in OpenOffice. Ruby code is enclosed in special markup:

+ `{%= %}` is for ruby code which should be output to the final document. `to_s` is applied to anything found inside this markup
+ `{% %}` is for everything else &mdash; loops, ifs, ends and any other non-outputting code

Any special formatting should by applied directly on the markup. E.g. if you need to ouput the value of variable title in bold font, write `{%= title %}`, select in in OpenOffice and make it bold. See the showcase.odt for more examples.

The same markup works in the document metadata (File &rarr; Properties) and inside
embedded objects such as charts. Put a chart inside a `{% for %}` loop and each
iteration gets its own chart filled with that iteration's data.

Contact
=======

kramar[dot]tomas[at]gmail.com