Pillar, one format for all supports Thibault Arloing Yann DUBOIS 26 - - PowerPoint PPT Presentation

▶
pillar one format for all supports
SMART_READER_LITE
LIVE PREVIEW

Pillar, one format for all supports Thibault Arloing Yann DUBOIS 26 - - PowerPoint PPT Presentation

Aug 19, 2022 270 likes •637 views

Pillar, one format for all supports Thibault Arloing Yann DUBOIS 26 aot 2016 1/35 Pillar 1 Pillar use cases 2 Whats new in Pillar 4.0 3 Make utilisation easier 4 Demo Time 5 Conclusion 6 2/35 Currently LaTeX Complicated Hard

slide-1
SLIDE 1

Pillar, one format for all supports

Thibault Arloing Yann DUBOIS 26 août 2016

1/35

slide-2
SLIDE 2

1

Pillar

2

Pillar use cases

3

What’s new in Pillar 4.0

4

Make utilisation easier

5

Demo Time

6

Conclusion

2/35

slide-3
SLIDE 3

3/35

Currently

LaTeX

Complicated Hard to debug Hard to convert to HTML

Markdown

Incomplete Incompatible Inplementation Few output formats

Thibault Arloing Yann DUBOIS Pillar, one format for all supports 26 août 2016 3 / 35

slide-4
SLIDE 4

4/35

Why Pillar ?

We wanted something : Easier than LaTeX More complete than Markdown

Thibault Arloing Yann DUBOIS Pillar, one format for all supports 26 août 2016 4 / 35

slide-5
SLIDE 5

5/35

Pillar

Thibault Arloing Yann DUBOIS Pillar, one format for all supports 26 août 2016 5 / 35

slide-6
SLIDE 6

6/35

Pillar

One input, many outputs (e.g. HTML, LaTeX, ePub)

Thibault Arloing Yann DUBOIS Pillar, one format for all supports 26 août 2016 6 / 35

slide-7
SLIDE 7

7/35

Pillar - EPub export

Thibault Arloing Yann DUBOIS Pillar, one format for all supports 26 août 2016 7 / 35

slide-8
SLIDE 8

8/35

Pillar

One input, many outputs (e.g. HTML, LaTeX, ePub) Slides / Books / Websites Textual syntax Easy to Extend Easy to use

Thibault Arloing Yann DUBOIS Pillar, one format for all supports 26 août 2016 8 / 35

slide-9
SLIDE 9

9/35

Pillar - Easy syntax

!Example This is an example of Pillar file. *Link>http://pharo.org*

  • Unordered Item
  • Unordered Item

#Ordered Item #Ordered Item [[[language=smalltalk|label=How to say Hello Transcript show: ’Hello !’. ]]] |!Harder |!Better |Faster |Stronger |More Than |Ever +Figure>file://path/to/the/file.png|width=80+

Thibault Arloing Yann DUBOIS Pillar, one format for all supports 26 août 2016 9 / 35

slide-10
SLIDE 10

10/35

Advanced features

${}$ annotation syntax Slides ${slide :Slide name}$ ${myAnnotation :arg1=1|arg2=2}$ Consistency in syntax [[[language=smalltalk|arg1=1|arg2=2]]] Evaluate a smalltalk script

Thibault Arloing Yann DUBOIS Pillar, one format for all supports 26 août 2016 10 / 35

slide-11
SLIDE 11

11/35

Pillar use cases

Thibault Arloing Yann DUBOIS Pillar, one format for all supports 26 août 2016 11 / 35

slide-12
SLIDE 12

12/35

Books written with Pillar

Enterprise Pharo : A Web Perspective Agile Virtualization Pharo By Example

Thibault Arloing Yann DUBOIS Pillar, one format for all supports 26 août 2016 12 / 35

slide-13
SLIDE 13

13/35

Books written with Pillar

Thibault Arloing Yann DUBOIS Pillar, one format for all supports 26 août 2016 13 / 35

slide-14
SLIDE 14

14/35

Presentations

Beamer DeckJs This presentation itself is written in Pillar

Thibault Arloing Yann DUBOIS Pillar, one format for all supports 26 août 2016 14 / 35

slide-15
SLIDE 15

15/35

Other use cases

Ecstatic : Static Websites, Guillermo Polito / Stéphane Ducasse (http ://guillep.github.io/ecstatic) PillarHub, Mike Filonov (http ://pillarhub.pharocloud.com/)

Thibault Arloing Yann DUBOIS Pillar, one format for all supports 26 août 2016 15 / 35

slide-16
SLIDE 16

16/35

What’s new in Pillar 4.0

Thibault Arloing Yann DUBOIS Pillar, one format for all supports 26 août 2016 16 / 35

slide-17
SLIDE 17

17/35

Pillar 4.0 - Structures

Dissociate form the shape Easy to use Provide from formatting mistakes

Thibault Arloing Yann DUBOIS Pillar, one format for all supports 26 août 2016 17 / 35

slide-18
SLIDE 18

18/35

Structures - How does it work

Thibault Arloing Yann DUBOIS Pillar, one format for all supports 26 août 2016 18 / 35

slide-19
SLIDE 19

19/35

Pillar 4.0 - Other features

Footnotes ${footnote :Text to put in the footnote}$ Citations ${cite :REF1713}$ Header Capitalization Hideable Scripts

Thibault Arloing Yann DUBOIS Pillar, one format for all supports 26 août 2016 19 / 35

slide-20
SLIDE 20

20/35

Make utilisation easier

Thibault Arloing Yann DUBOIS Pillar, one format for all supports 26 août 2016 20 / 35

slide-21
SLIDE 21

21/35

Hell on boot project

Where is my configuration file ? Where are templates ? I am bored of copy/paste parts of configuration file Where did I put my pillar files ?

Thibault Arloing Yann DUBOIS Pillar, one format for all supports 26 août 2016 21 / 35

slide-22
SLIDE 22

22/35

Pillar Archetypes - Skeleton maker

Simple utilisation Build a project base with example files Many archetypes (Book / Slides / Beginner)

./ pillar archetype book

Thibault Arloing Yann DUBOIS Pillar, one format for all supports 26 août 2016 22 / 35

slide-23
SLIDE 23

23/35

Pillar Archetype - How does it work ?

Thibault Arloing Yann DUBOIS Pillar, one format for all supports 26 août 2016 23 / 35

slide-24
SLIDE 24

24/35

Makefile Archetypes

Makefile adapted to each Archetypes Separated Makefiles

Thibault Arloing Yann DUBOIS Pillar, one format for all supports 26 août 2016 24 / 35

slide-25
SLIDE 25

25/35

Makefile Job

Begin with a pillar file

Thibault Arloing Yann DUBOIS Pillar, one format for all supports 26 août 2016 25 / 35

slide-26
SLIDE 26

26/35

Makefile Job

Thibault Arloing Yann DUBOIS Pillar, one format for all supports 26 août 2016 26 / 35

slide-27
SLIDE 27

27/35

Makefile Job

Pass through Pillar

$( OUTPUTDIRECTORY )/%. html.json: %. pillar copySupport ./ pillar export

  • -to=" html" --outputFile =$@ $<

Thibault Arloing Yann DUBOIS Pillar, one format for all supports 26 août 2016 27 / 35

slide-28
SLIDE 28

28/35

Makefile Job

Thibault Arloing Yann DUBOIS Pillar, one format for all supports 26 août 2016 28 / 35

slide-29
SLIDE 29

29/35

Makefile Job

Pass through a template System

./ mustache

  • -data=$< --template=${ HTMLTEMPLATE } > $@

Thibault Arloing Yann DUBOIS Pillar, one format for all supports 26 août 2016 29 / 35

slide-30
SLIDE 30

30/35

Makefile Job

Thibault Arloing Yann DUBOIS Pillar, one format for all supports 26 août 2016 30 / 35

slide-31
SLIDE 31

31/35

Demo Time

Thibault Arloing Yann DUBOIS Pillar, one format for all supports 26 août 2016 31 / 35

slide-32
SLIDE 32

32/35

Conclusion

Thibault Arloing Yann DUBOIS Pillar, one format for all supports 26 août 2016 32 / 35

slide-33
SLIDE 33

33/35

Future Works

Pharo comments in Pillar Mobi Exporter Math expressions in LaTeX We have a lot of suggestions from community

Thibault Arloing Yann DUBOIS Pillar, one format for all supports 26 août 2016 33 / 35

slide-34
SLIDE 34

34/35

Conclusion

Easy to Extend Easy Syntax Lot of output Easier Compilation Possibility to use other tools for templating

Thibault Arloing Yann DUBOIS Pillar, one format for all supports 26 août 2016 34 / 35

slide-35
SLIDE 35

35/35

For more informations

https ://ci.inria.fr/pharo- contribution/job/EnterprisePharoBook/lastSuccessfulBuild/artifact/book- result/PillarChap/Pillar.html

Thibault Arloing Yann DUBOIS Pillar, one format for all supports 26 août 2016 35 / 35