Le lundi 01 février 2021 à 15:50 -0500, Shaun McCance a écrit :
On Wed, 2021-01-27 at 13:44 -0800, Karsten Wade wrote:
>
> There are also some web designer skills needed around styling the
> Asciidoc output, including building a multi-page website for the
> HTML
> version (perhaps generated by Antora?).
>
> Shaun—what skill gaps do we have around the various book rendering
> tools?
I'm going to try to bullet point skills people could bring. I have
varying levels of experience across these points, but I don't need to
own any of them if others are eager.
* Visual style work. Document design is related to but distinct from
graphic design. I have some experience, and I put together a draft of
a
start of a visual identity. I'll remind the crowd that I am red-green
colorblind, so I always copy color palettes from others, and even
then
I might mess up.
* CSS work to implement the visual style in HTML. I do this kind of
thing often enough.
* Asciidoctor experience to make sure our CSS and whatever else is
smoothly fits into how docs are generated, and aren't hacks on top.
* Work with asciidoctor-pdf (and possibly the underlying renderer
Prawn) to implement our style. I have some print experience, but it's
old, and tools are new. I can figure it out, but I have to yell at
clouds first or something.
* Site publishing/orchestration work. Is Antora the answer? Maybe,
maybe not. But different pieces of the site come from different
places,
and there's not a clean publishing story.
For that part, now my team has a openshift cluster for production, we
can help. It is much easier to have a pipeline of heteroclite toolsthan before.
--
Michael Scherer / He/Il/Er/Él
Sysadmin, Community Infrastructure