Ir al contenido principal

Ralsina.Me — El sitio web de Roberto Alsina

Publicaciones sobre programming (publicaciones antiguas, página 51)

AAFigure en rst2pdf

Que sig­ni­fi­ca? Que po­dés po­ner es­to en tu do­cu­men­to:

+-------+       +-------+
|   A   |------>|   B   |
+-------+       +-------+

Y ob­te­nés es­to (y co­mo par­te del PDF, no co­mo ima­gen, así que se pue­de co­piar el tex­to­):

/static/aafigure.png

Así que es una bue­ní­si­ma ma­ne­ra de ha­cer dia­gra­mas sim­ples en tus do­cu­men­tos de res­truc­tu­red text que se ven bien en tex­to pla­no, en la we­b, y en PDF.

Aafi­gu­re pue­de crear mon­to­nes de dia­gra­mas in­te­re­san­tes, mi­rá el ma­nual pa­ra ver ejem­plo­s.

Ac­tual­men­te re­quie­re aafi­gu­re de bzr (0.3 no al­can­za).

Rst2pdf 0.11 liberado!

It's my plea­su­re to an­noun­ce the re­lea­se of rs­t2­pdf ver­sion 0.11, avai­la­ble at http://­co­de.­google.­co­m/­p/rs­t2­pdf/­do­wn­load­s/­list

Rs­t2­pdf is a tool to ge­ne­ra­te PDF fi­les di­rec­tly from res­truc­tu­red text sour­ces via re­por­tla­b.

This ver­sion in­clu­des many bu­gfixes and so­me new fea­tu­res com­pa­red to the pre­vious 0.10.1 ver­sio­n, in­clu­ding but not li­mited to em­be­dding PDF ima­ges, mu­ch im­pro­ved ima­ge si­zin­g, ni­cer list la­you­ts, be­tter sty­lin­g, pa­ge ba­ck­groun­d­s, and mo­re than 15 bugs fixe­d. A fu­ll chan­ge­log is in­clu­ded at the bo­ttom of this me­ss­age.

Rs­t2­pdf ai­ms to su­pport the fu­ll res­truc­tu­red text fea­tu­re se­t, and is ve­ry clo­se to that goa­l, whi­le al­so in­clu­ding so­me of the mo­re ex­pe­ri­men­tal fea­tu­res, like a sour­ce co­de di­rec­ti­ve wi­th syn­tax hi­gh­li­gh­ting and ma­th no­ta­tion su­pport wi­th La­TeX-­like syn­ta­x.

It su­ppor­ts em­be­dding ar­bi­tra­ry fon­ts, bo­th True Ty­pe and PS Ty­pe 1, bo­th ras­ter and vec­tor ima­ges (in­clu­ding SV­G), pa­ge tran­si­tion effec­ts, mul­ti­ple, fle­xi­ble pa­ge la­you­ts, cas­ca­ding sty­le­s, and mu­ch, mu­ch mo­re.

You can find mo­re in­for­ma­tion about rs­t2­pdf in its ho­me pa­ge ( http://rs­t2­pdf.­google­co­de.­com), and ask an­y­thing you want in the rs­t2­pdf- dis­cuss mai­ling list (http://­group­s.­google.­co­m/­grou­p/rs­t2­pdf-­dis­cuss)

He­re are the chan­ges in this ver­sion com­pa­red to 0.10.1:

  • De­­gra­­de mo­­­re gra­­ce­­fu­­lly when one or mo­­­re wo­r­­da­­xe hy­­phe­­na­­tors are bro­­ken (cu­­rren­­tly DWC is the bro­­ken one)

  • Fixed is­­sue 132: in so­­­me ca­ses, wi­­th use­­r-­­de­­fi­­ned fo­n­­tA­­lia­s, bold and ita­­lic would get co­n­­fu­s­ed (ge­­tting ita­­lic in­s­­tead of bold in in­­li­­ne ma­­rku­­p, for in­s­­tan­­ce).

  • New sty­­le­s­heet no­­-­­co­m­­pa­c­­t-­­lis­­ts to make lis­­ts... le­ss co­m­­pact

  • SVG ima­­ges now han­d­­le % as a wi­­dth unit co­­­rre­c­­tl­­y.

  • Im­­ple­­men­ted is­­sue 127: su­­pport ima­­ges in PDF fo­r­­ma­­t. Ri­­ght now they are ra­s­­te­­ri­­ze­­d, so it's not idea­­l. Perhaps so­­­me­­thing be­­­tter wi­­ll co­­­me up la­­te­­r.

  • Fixed is­­sue 129: make it wo­­­rk around a pr­­blem wi­­th Kee­p­­To­­­ge­­ther in RL 2.1 it pro­­­ba­­bly makes the ou­­tput look wo­r­­se in so­­­me ca­­ses when using tha­­t. RL 2.1 is not rea­­lly su­­ppor­te­­d, so added a wa­r­­ni­n­­g.

  • Fixed is­­sue 130: use os.­­pa­­thsep in­s­­tead of ":" si­n­­ce ":" in wi­n­­do­­ws is us­ed in disk na­­mes (and we sti­­ll pay for DOS idio­­­c­­y, in 2009)

  • Fixed is­­sue 128: hea­­dings le­­vel 3+ all looked the sa­­me

  • Ugly bu­­gfix for Is­­sue 126: cra­s­hes when using ima­­ges in hea­­der + TOC

  • New ts­­ty­­les se­c­­tion in the sty­­le­s­heet pro­­­vi­­des mo­­­re co­n­­fi­­gu­­ra­­ble list la­­you­­ts and mo­­­re po­­we­r­­ful ta­­ble sty­­li­n­­g.

  • Be­­­tter syn­­tax hi­­gh­­li­­gh­­ting (su­­ppo­r­­ts bo­l­­d/i­­ta­­li­­c)

  • Wo­­­rka­­round for is­­sue 103 so you can use bo­r­­de­r­­Pa­­dding as a list (but it wi­­ll look wrong if you are using wo­r­­da­­xe <= 0.3.2)

  • Added fie­l­­d­­va­­lue sty­­le for field lis­­ts

  • Added op­­tio­n­­list ts­­ty­­le, for op­­tion lis­­ts

  • Added co­­­lle­c­­tion of uti­­li­­ty sty­­le­s­hee­­ts and do­­­cu­­men­ted it

  • Im­­pro­­­ved co­­­m­­mand li­­ne pa­r­­sing and sty­­le­s­heet loading (guess ex­­ten­­sion like la­­test rs­­t2­­la­­tex does)

  • Fixed Is­­sue 67: co­m­­ple­­te­­ly new list la­­you­­ting co­­­de

  • Fixed Is­­sue 116: cra­s­hes cau­s­ed by hu­­ge ima­­ges

  • Be­­­tter su­­pport for %wi­­dth in ima­­ges, n2ow it's % of the co­n­­tai­­ner fra­­me's wi­­dth, not of the text area.

  • Fixed bug in SVG sca­­ling

  • Be­­­tter han­d­­ling of mis­­sing ima­­ges

  • Added mis­­sing sty­­les abs­­tra­c­­t, co­n­­ten­­ts, de­­di­­ca­­tion to the de­­fault sty­­le­s­heet

  • Ta­­bles sty­­le su­­pport spa­­ce­­Be­­­fo­­­re and spa­­ceA­­fter

  • New to­­­pi­­c-­­ti­­tle sty­­le for to­­­pic ti­­tles (o­b­­vious ;-)

  • Ve­r­­ti­­cal ali­g­n­­ment for in­­li­­ne ima­­ges (:­a­­li­g­n: pa­­ra­­me­­te­­r)

  • Is­­sue 118: Su­­pport for :s­­ca­­le: in ima­­ges and han­d­­le re­­si­­zing of in­­li­­ne ima­­ges

  • Is­­sue 119: Fix pla­­ce­­ment of hea­­ders and footers

  • New ba­­ck­­ground pro­­­pe­r­­ty for pa­­ge te­m­­pla­­tes (ni­­ce for pre­sen­­ta­­tio­n­s, for exa­m­­ple)

  • De­­fault to px for ima­­ge wi­­dth spe­­ci­­fi­­ca­­tions in­s­­tead of pt

  • Su­­pport all re­­qui­­red mea­­su­­re­­ment uni­­ts ("e­­m" "ex" "px" "i­n" "cm" "m­­m" "p­­t" "p­­c" "%" "")

  • New au­­to­­­mated scri­p­­ts to che­­ck test ca­­ses for "vi­­sual di­­ffe­­ren­­ce­s"

  • Res­­pect ima­­ges DPI pro­­­pe­r­­ty a bit like rs­­t2­­la­­tex does.

  • Is­­sue 110: New --i­n­­li­­ne-­­footno­­­tes op­­tion

  • Tes­ted wi­­th re­­po­r­­tlab from SVN trunk

  • Su­­pport for Di­­nu Ghe­r­­man's sv­­gli­­b. If bo­­­th sv­­glib and uni­­co­n­­ve­r­­tor are avai­­la­­ble, sv­­glib is pre­­fe­­rred (for SV­­G, of cou­r­se). Pa­­tch ori­­gi­­na­­lly by ru­­te.

  • Is­­sue 109: Se­­pa­­ra­­te sty­­les for ea­­ch kind of ad­­mo­­­ni­­tion

  • For Is­­sue 109: mis­­sing sty­­les are not a fa­­tal error

  • Is­­sue 117: TO­­­Cs wi­­th mo­­­re than 6 le­­vels now su­­pported (rai­s­ed li­­mit to 9, whi­­ch is si­­lly dee­­p)

Reporte de avances en rst2pdf

Al fi­nal de es­te post vas a en­con­trar una lis­ta (tal vez in­com­ple­ta), pe­ro que­ría com­par­tir un par de avan­ces re­la­ti­va­men­te gran­de­s.


Pre­sen­ta­cio­nes

Ven­go que­rien­do ha­cer que rs­t2­pdf sea útil pa­ra pre­sen­ta­cio­nes des­de ha­ce bas­tan­te tiem­po. Y se es­tá acer­can­do.

Es­toy es­cri­bien­do un pe­que­ño tu­to­rial del te­ma, pe­ro ya se pue­de ver una de­mo.

Los cam­bios que la han he­cho po­si­ble so­n:

  • Arre­­glé bugs en el la­­yout de la pá­­gi­­na

  • Agre­­gué so­­­po­r­­te pa­­ra fo­n­­dos de pá­­gi­­na (i­n­­clu­­yen­­do SV­­G!)

Es­to es en gran me­di­da gra­cias a que`­Cé­sar Ro­da­s`_ que­ría usar al­go sim­ple y ba­sa­do en tex­to pa­ra su pre­sen­ta­ción a Zen­dCo­n, me pre­gun­tó y me da­ba ver­güen­za dar­le una co­sa que no fun­cio­na­ba.

Ven co­mo fun­cio­na? Me ma­ne­ja la ver­güen­za. Que ver­güen­za.


Gran­des me­jo­ras en es­ti­los

Los cam­bios re­la­cio­na­dos son mu­chí­si­mos (ver aba­jo­), pe­ro tam­bién fué por un mo­ti­vo: quie­ro ha­cer do­cu­men­tos más lin­do­s.

En­ton­ce­s, ya que a mu­cha gen­te pa­re­ce gus­tar­le es es­ti­lo de Sphi­n­x, qui­se ha­cer uno si­mi­la­r.

Lo lo­gré? Si y no, mi­ren:

web-sphinxrst2pdf-sphinx

Igual eso es só­lo un bo­rra­do­r, no mi­ré los fon­ts, ni el pe­so de los en­ca­be­za­do­s, ni si­quie­ra que es­que­ma de co­lo­res usa pa­ra el có­di­go.

De to­das ma­ne­ra­s, aún es­te sty­les­heet mí­ni­mo me hi­zo en­con­trar una do­ce­na de bugs y pro­ble­mas en rs­t2­pdf.

Mo­ra­le­ja: por fa­vor dí­gan­me que pue­den y qué no pue­den ha­cer con rs­t2­pdf por­que hay áreas que ni mi­ro!


Lo úl­ti­mo es... el pr­óxi­mo re­lea­se va a es­tar bue­ní­si­mo. Pe­ro siem­pre di­go lo mis­mo, no?


Cam­bios has­ta ho­y:

  • Wo­­­rka­­round for is­­sue 103 so you can use bo­r­­de­r­­Pa­­dding as a list (but it wi­­ll look wrong if you are using wo­r­­da­­xe <= 0.3.2)

  • Added fie­l­­d­­va­­lue sty­­le for field lis­­ts

  • Added op­­tio­n­­list ts­­ty­­le, for op­­tion lis­­ts

  • Added co­­­lle­c­­tion of uti­­li­­ty sty­­le­s­hee­­ts and do­­­cu­­men­ted it

  • Im­­pro­­­ved co­­­m­­mand li­­ne pa­r­­sing and sty­­le­s­heet loading (guess ex­­ten­­sion like la­­test rs­­t2­­la­­tex does)

  • Fixed Is­­sue 67: co­m­­ple­­te­­ly new list la­­you­­ting co­­­de

  • Fixed Is­­sue 116: cra­s­hes cau­s­ed by hu­­ge ima­­ges

  • Be­­­tter su­­pport for %wi­­dth in ima­­ges, n2ow it's % of the co­n­­tai­­ner fra­­me's wi­­dth, not of the text area.

  • Fixed bug in SVG sca­­ling

  • Be­­­tter han­d­­ling of mis­­sing ima­­ges

  • Added mis­­sing sty­­les abs­­tra­c­­t, co­n­­ten­­ts, de­­di­­ca­­tion to the de­­fault sty­­le­s­heet

  • Ta­­bles sty­­le su­­pport spa­­ce­­Be­­­fo­­­re and spa­­ceA­­fter

  • New to­­­pi­­c-­­ti­­tle sty­­le for to­­­pic ti­­tles (o­b­­vious ;-)

  • Ve­r­­ti­­cal ali­g­n­­ment for in­­li­­ne ima­­ges (:­a­­li­g­n: pa­­ra­­me­­te­­r)

  • Is­­sue 118: Su­­pport for :s­­ca­­le: in ima­­ges and han­d­­le re­­si­­zing of in­­li­­ne ima­­ges

  • Is­­sue 119: Fix pla­­ce­­ment of hea­­ders and footers

  • New ba­­ck­­ground pro­­­pe­r­­ty for pa­­ge te­m­­pla­­tes (ni­­ce for pre­sen­­ta­­tio­n­s, for exa­m­­ple)

  • De­­fault to px for ima­­ge wi­­dth spe­­ci­­fi­­ca­­tions in­s­­tead of pt

  • Su­­pport all re­­qui­­red mea­­su­­re­­ment uni­­ts ("e­­m" "ex" "px" "i­n" "cm" "m­­m" "p­­t" "p­­c" "%" "")

  • New au­­to­­­mated scri­p­­ts to che­­ck test ca­­ses for "vi­­sual di­­ffe­­ren­­ce­s"

  • Res­­pect ima­­ges DPI pro­­­pe­r­­ty a bit like rs­­t2­­la­­tex does.

  • Is­­sue 110: New --i­n­­li­­ne-­­footno­­­tes op­­tion

  • Tes­ted wi­­th re­­po­r­­tlab from SVN trunk

  • Su­­pport for Di­­nu Ghe­r­­man's sv­­gli­­b. If bo­­­th sv­­glib and uni­­co­n­­ve­r­­tor are avai­­la­­ble, sv­­glib is pre­­fe­­rred (for SV­­G, of cou­r­se). Pa­­tch ori­­gi­­na­­lly by ru­­te.

  • Is­­sue 109: Se­­pa­­ra­­te sty­­les for ea­­ch kind of ad­­mo­­­ni­­tion

  • For Is­­sue 109: mis­­sing sty­­les are not a fa­­tal error

  • Is­­sue 117: TO­­­Cs wi­­th mo­­­re than 6 le­­vels now su­­pported (rai­s­ed li­­mit to 9, whi­­ch is si­­lly dee­­p)

Salió rst2pdf 0.10!

Si no sa­bés de que es­toy ha­blan­do, rs­t2­pdf te per­mi­te crear PDFs a par­tir de un sim­ple, ape­nas "mar­ca­do" for­ma­to de tex­to lla­ma­do tex­to rees­truc­tu­ra­do y es la ma­ne­ra más sen­ci­lla de crear do­cu­men­ta­ción pa­ra tu pro­yec­to de so­ftwa­re li­bre, y mu­cho má­s!

Aquí es­tá el ma­nual que se creó usan­do el mis­mo rs­t2­pdf a par­tir de es­to.

Y aquí es­tá la (pro­ba­ble­men­te in­com­ple­ta) lis­ta de los cam­bio­s, que te de­be­rían con­ven­cer de que es­ta ver­sión es la que ne­ce­si­ta­s:

  • Is­­sue 87: Ta­­ble hea­­ders can be re­­peated in ea­­ch pa­­ge (thanks to Ya­­sus­hi Ma­­su­­da)

  • Is­­sue 93: Li­­ne nu­m­­ber su­­pport for co­­­de blo­­­cks (:­­li­­ne­­no­­s: true)

  • Is­­sue 111: Added --­­no­­-­­footno­­­te-­­ba­­ck­­li­nks op­­tion

  • Is­­sue 107: Su­­pport lo­­­ca­­li­­zed di­­re­c­­ti­­ve­s/­­ro­­­les (e­­xa­m­­ple: so­­­m­­mai­­re in­s­­tead of co­n­­ten­­ts)

  • Is­­sue 112: Fixed crash when pro­­­ce­s­­sing em­p­­ty list ite­­ms

  • Is­­sue 98: No­­­break su­­ppo­r­­t, and set as de­­fault for in­­li­­ne-­­li­­te­­rals so they do­­n't hy­­phe­­na­­te.

  • Sli­­gh­­tly be­­­tter tes­­ts

  • Ba­­ck­­ground co­­­lors in text sty­­les wo­­­rk wi­­th re­­po­r­­tlab 2.3

  • Is­­sue 99: Fixed hy­­phe­­na­­tion in hea­­de­r­s/­­footers (re­­qui­­res wo­r­­da­­xe 0.3.2)

  • Is­­sue 106: Crash on de­­mo­­.­­txt fixed (re­­qui­­res wo­r­­dxe 0.3.2)

  • Is­­sue 102: Im­­ple­­men­ted sty­­les for bu­­lle­ted and nu­m­­be­­­red lis­­ts

  • Is­­sue 38: De­­fault hea­­de­r­s/­­footers via op­­tio­n­s, co­n­­fig fi­­le or sty­­le­s­heet

  • Is­­sue 88: Im­­ple­­men­ted mu­­ch be­­­tter book-s­­ty­­le TO­­­Cs

  • Is­­sue 100: Fixed bug wi­­th hea­­de­r­s/­­footers and Re­­po­r­­tlab 2.3

  • Is­­sue 95: Fixed bug wi­­th in­­den­ted ta­­bles

  • Is­­sue 89: Im­­ple­­men­ted --­­ve­r­­sion

  • Is­­sue 84: Fixed bug wi­­th re­­la­­ti­­ve in­­clu­­de pa­­ths

  • Is­­sue 85: Fixed bug wi­­th ta­­ble ce­­ll sty­­les

  • Is­­sue 83: Fixed bug wi­­th nu­­me­­ric co­­­lors in ba­­ck­­Co­­­lor attri­­bu­­te

  • Is­­sue 44: Su­­pport for stdin and stdout

  • Is­­sue 79: Added --s­­ty­­le­s­hee­­t-­­pa­­th op­­tion

  • Is­­sue 80: Send wa­r­­nings to stde­­rr, not stdout

  • Is­­sue 66: Im­­ple­­men­ted "s­­mart quo­­­tes"

  • Is­­sue 77: Wo­­­rk around mis­­sing ma­­tplo­­­tlib

  • Pro­­­per tran­s­­la­­tion of la­­bels (su­­ch as "Au­­tho­­­r", "Ve­r­­sio­­n" etc.) using the do­­­cu­­tils lan­­gua­­ges pa­­cka­­ge. (r473)

  • Fixed pro­­­ble­­ms wi­­th wrong or no­­n-e­­xis­­ting fo­n­­ts. (r484)

  • Pa­­ge tran­­si­­tion effect su­­pport for pre­sen­­ta­­tions (r423)


Contents © 2000-2024 Roberto Alsina