May 2024 - ntg-context - Mailing Lists

Wiki - test/proposal to further clarify documentation
by garulfo＠azules.eu 19 May '24

19 May '24

Hi all, I just discover the Diátaxis documentation framework : - https://www.diataxis.fr/ - 30min video : "What nobody tells you about documentation", https://www.youtube.com/watch?v=t4vKPhjcMZg , from Daniele Procida at PyCon 2017 As I understand it, it can help both readers and writers of the documentation by clarifying the purpose of each element. So I started a potential new "welcome page" : https://wiki.contextgarden.net/Main_Page2 The main lines would be : - Tutorials: installation pages, step by step examples - How-to guides: most of the existing wiki pages which are not https://wiki.contextgarden.net/Commands/ ... - Discussions and manuals: most of the existing manuals - Reference : the pages dedicated to commands which already include link to mailing list, stack exchange, ConTeXt's source - https://wiki.contextgarden.net/Category:Commands - https://wiki.contextgarden.net/Special:PrefixIndex?prefix=Command%2F To match the logic of Diátaxis, maybe some material from command pages should be moved from "Reference" to "How-to guides", for example, when the examples go beyond "pure description" and begin to deal with "how-to" cases, e.g. : - Reference for setuphead: https://wiki.contextgarden.net/Command/setuphead - How-to guides for headings: https://wiki.contextgarden.net/Titles If it make sense, and according to your feedbacks, I can continue to reallocate existing contents. Thanks for your feedback and thoughts. Garulfo

9 17

MyWay from dl.contextgarden.net
by garulfo＠azules.eu 19 May '24

19 May '24

Several documents previously stored on dl.contextgarden.net are no longer accessible. https://wiki.contextgarden.net/This_Way_-_My_Way#MyWay Are they available on another server ? or is there a copy somewhere else ? Thanks for your help Garulfo

2 2

Why is only the first frame protruding into the margin?
by madiazm.eoicc＠gmail.com 18 May '24

18 May '24

Hi, I used some code from the meta-fun manual to recreate a labelled frame around my sections. But the first framedtext protrudes a couple of mm into the margin. Only the first one in the page. I intentionaly added other sections and the frames aline to the margin ok. I tried to put something before the first frame (noindentation, dontleavehmode) because I sometimes read it solves problems, but not the case here. so Why is the first frame protruding and only the first? \definepapersize[vertical][A4, portrait] \definepapersize[horizontal][A4, landscape] \setuppapersize[vertical] \setuplayout[location=middle, marking=off, topspace=1cm, topdistance=0cm, backspace=2.5cm, height=fit, width=fit, rightedge=5mm, rightedgedistance=0cm, rightmargin=20mm, rightmargindistance=7mm, leftmargin=1.5cm, header=1cm, headerdistance=.5cm, bottomspace=.5cm, bottomdistance=0mm, footer=.8cm, footerdistance=.2cm, setup=strict,] \startuseMPgraphic{FunnyFrame} picture p ; numeric w, h, o ; p := textext.rt(\MPstring{FunnyFrame}) ; w := OverlayWidth ; h := OverlayHeight ; o := BodyFontSize ; p := p shifted (2o,h-ypart center p) ; draw p ; drawoptions (withpen pencircle scaled .25pt withcolor blue) ; draw (2o,h)--(0,h)--(0,0)--(w,0)--(w,h)--(xpart urcorner p,h) ; %draw boundingbox p ; %%%quitamos el frame pequeño setbounds currentpicture to unitsquare xyscaled(w,h) ; \stopuseMPgraphic \defineoverlay[FunnyFrame][\useMPgraphic{FunnyFrame}] \defineframedtext[FunnyText][width=.85\textwidth, height=20mm, frame=off, background=FunnyFrame, align=flushright,location=right, after={\blank[2*big]}]%foregroundsytel amplía la palabra Apartado \def\FrameTitle#1% {\setMPtext{FunnyFrame}{\hbox spread 1em{\hss\strut \color[blue]{\tfx Apartado #1}\hss}}} \setMPtext{FunnyFrame}{} % initialize the text variable \define[2]\firstHeadings{% \dontleavehmode \switchtobodyfont[miCorm] \FrameTitle#1% \dontleavehmode \startFunnyText {\switchtobodyfont[miCorm,20.7pt] #2} \stopFunnyText } \setuphead [section] [color=blue, command=\firstHeadings, indentnext=no] \starttext \noindentation \dontleavehmode \startsection[title=Aspectos generales] Esta guía contiene toda la documentación necesaria para administrar la prueba unificada de certificación que ha diseñado la comisión de alemán. Se ruega al profesorado\footnote{Todas las alusiones a la forma del masculino genérico que se recogen en este documento deberán entenderse referidas a la condición masculina o femenina de cada persona según corresponda.} que se familiarice con las secciones del documento a través del índice y acuda a ellas según vaya siendo necesario, de manera que se pueda administrar y corregir la prueba de la manera más satisfactoria posible. \stopsection \startsection[title=another section] Las carpetas con las pruebas aparecen nombradas por idioma, nivel y set de pruebas, no apareciendo ninguna referencia a convocatorias anuales ni tampoco fechas. Sí aparece la referencia a la convocatoria en cada una de las guías de administración para los diferentes niveles. \stopsection \startsection[title=another section] La carpeta correspondiente a cada nivel contiene las distintas actividades de lengua, los audios para CTO y el audio/vídeo base para la mediación escrita. Además contiene esta guía con la información necesaria para tener una visión global de la prueba: los solucionarios, transcripciones, tablas de corrección, tablas de conversión y la rúbrica para la mediación escrita. Igualmente se incorporarán o enlazarán subcarpetas con los archivos necesarios para las pruebas orales: monólogos, diálogos y mediaciones orales. \stopsection \stoptext

5 12

Cron <context@cgl> /var/www/aanhet.net/context/bin/cron/context-mirror
by root＠ntg.nl 17 May '24

17 May '24

receiving incremental file list ./ ctan.lsr document-2.htm download-1.htm download-2.htm logo-ade.png logo-cts.png logo-pod.png rss.xml show-fil.pdf context/latest/ context/latest/cont-lmt.zip context/latest/cont-mpd.zip context/latest/cont-ppc.zip context/latest/cont-sci.zip context/latest/cont-tmf.zip context/latest/cont-tst.7z context/latest/cont-tst.tar.xz context/latest/cont-tst.zip general/manuals/ general/manuals/pdfmerge.pdf general/qrcs/ general/qrcs/setup-mapping-en.pdf general/qrcs/setup-mapping-it.pdf sent 185,981 bytes received 43,500,122 bytes 2,647,642.61 bytes/sec total size is 581,971,883 speedup is 13.32 Running archiver: New dir: /var/www/aanhet.net/context//htdocs/archives/context-2024-05-17.17 248030043 /var/www/aanhet.net/context//htdocs/archives/context-2024-05-17.17/latest 126745317 /var/www/aanhet.net/context//htdocs/archives/context-2024-05-17.17/current 374779456 /var/www/aanhet.net/context//htdocs/archives/context-2024-05-17.17 374779456 total

1 0

update
by Hans Hagen 17 May '24

17 May '24

Hi, This weekends update: - we're currently checking the upcoming math manual and in the process we streamline some mechanisms - as part of the BT presentation about par passes we introduced \toddlerpenalty but we leave it to the user to guess what that is (it fits into widow, club and orphan penalty collection) - we could already produce pdf 2.0 but especially when one mises with older files, some care is needed; the inclusion 'compact' mechanism has been cleaned up a bit and the merge interface is converging (it has to do with efficient font sharing, cleanup and fixing of files outside our control); when one has issues with inclusion, try with compact= (set to nothing) - although we're mostly done with tagging it will get some attention as we go; it's mostly about playing safe and getting valid pdf's - for rhaban (posters) another fancy feature was added: \startTEXpage[offset=1ts] \samplefile{tufte}\removeunwantedspaces\space \startshadow[contrastcolor=red,weight=100]\blue\samplefile{tufte}\removeunwantedspaces\stopshadow\space \samplefile{tufte}\removeunwantedspaces\space \startshadow[contrastcolor=red,weight=100,dx=0,dy=0]\blue\samplefile{tufte}\removeunwantedspaces\stopshadow\space \samplefile{tufte} \blank \setupshadows[shadowed][unit=pt,dx=.5,dy=-.5,weight=200] \shadowed{\bfd Tufte\setstrut\strut} \stopTEXpage Hans ----------------------------------------------------------------- Hans Hagen | PRAGMA ADE Ridderstraat 27 | 8061 GH Hasselt | The Netherlands tel: 038 477 53 69 | www.pragma-ade.nl | www.pragma-pod.nl -----------------------------------------------------------------

1 0

Cron <context@cgl> /var/www/aanhet.net/context/bin/cron/context-mirror
by root＠ntg.nl 16 May '24

16 May '24

rsync: [Receiver] failed to connect to rsync.pragma-ade.nl (213.125.29.165): No route to host (113) rsync error: error in socket IO (code 10) at clientserver.c(139) [Receiver=3.2.7]

1 0

Cron <context@cgl> /var/www/aanhet.net/context/bin/cron/context-mirror
by root＠ntg.nl 16 May '24

16 May '24

rsync: [Receiver] failed to connect to rsync.pragma-ade.nl (213.125.29.165): No route to host (113) rsync error: error in socket IO (code 10) at clientserver.c(139) [Receiver=3.2.7]

1 0

Is there any command that equates to "keep with previous paragraph"?
by Joel 16 May '24

16 May '24

If I have text like this, it interprets the gap as needing a paragraph break: This is some text. This is some other text, it will appear in a new paragraph. Is there any macro I can place that will ignore the gap before it, treating the next text as if it belongs at the end of that sentence? Ex. This is some text. \ignorebreak This is some other text, it will appear in a new paragraph. That way output is more like this: This is some text. This is some other text, it will appear in a new paragraph. --Joel

2 1

Cron <context@cgl> /var/www/aanhet.net/context/bin/cron/context-mirror
by root＠ntg.nl 16 May '24

16 May '24

rsync: [Receiver] failed to connect to rsync.pragma-ade.nl (213.125.29.165): No route to host (113) rsync error: error in socket IO (code 10) at clientserver.c(139) [Receiver=3.2.7]

1 0

Cron <context@cgl> /var/www/aanhet.net/context/bin/cron/context-mirror
by root＠ntg.nl 16 May '24

16 May '24

rsync: [Receiver] failed to connect to rsync.pragma-ade.nl (213.125.29.165): No route to host (113) rsync error: error in socket IO (code 10) at clientserver.c(139) [Receiver=3.2.7]

1 0