* [ptxdist] [PATCH] doc: highlight inline code with gray box
@ 2020-09-11 9:23 Enrico Jorns
2020-09-11 10:01 ` Michael Olbrich
0 siblings, 1 reply; 4+ messages in thread
From: Enrico Jorns @ 2020-09-11 9:23 UTC (permalink / raw)
To: ptxdist; +Cc: Enrico Jorns
This should ease distinguishing inline code snippets from default text
and is also more similar to what the sphinx html outputs look like.
Signed-off-by: Enrico Jorns <ejo@pengutronix.de>
---
doc/preamble.inc | 3 +++
1 file changed, 3 insertions(+)
diff --git a/doc/preamble.inc b/doc/preamble.inc
index d9e528ef4..3131987af 100644
--- a/doc/preamble.inc
+++ b/doc/preamble.inc
@@ -82,6 +82,9 @@
\definecolor{VerbatimColor}{gray}{0.95}
\definecolor{VerbatimBorderColor}{gray}{0.75}
+% override default sphinxcode to display gray-colored box
+\protected\def\sphinxcode#1{\fcolorbox[gray]{1}{0.9}{\texttt{#1}}}
+
\makeatother
% vim:syntax=tex
--
2.28.0
_______________________________________________
ptxdist mailing list
ptxdist@pengutronix.de
To unsubscribe, send a mail with subject "unsubscribe" to ptxdist-request@pengutronix.de
^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: [ptxdist] [PATCH] doc: highlight inline code with gray box
2020-09-11 9:23 [ptxdist] [PATCH] doc: highlight inline code with gray box Enrico Jorns
@ 2020-09-11 10:01 ` Michael Olbrich
2020-09-11 10:07 ` Enrico Jörns
0 siblings, 1 reply; 4+ messages in thread
From: Michael Olbrich @ 2020-09-11 10:01 UTC (permalink / raw)
To: ptxdist; +Cc: Enrico Jorns
On Fri, Sep 11, 2020 at 11:23:31AM +0200, Enrico Jorns wrote:
> This should ease distinguishing inline code snippets from default text
> and is also more similar to what the sphinx html outputs look like.
>
> Signed-off-by: Enrico Jorns <ejo@pengutronix.de>
> ---
> doc/preamble.inc | 3 +++
> 1 file changed, 3 insertions(+)
>
> diff --git a/doc/preamble.inc b/doc/preamble.inc
> index d9e528ef4..3131987af 100644
> --- a/doc/preamble.inc
> +++ b/doc/preamble.inc
> @@ -82,6 +82,9 @@
> \definecolor{VerbatimColor}{gray}{0.95}
> \definecolor{VerbatimBorderColor}{gray}{0.75}
>
> +% override default sphinxcode to display gray-colored box
> +\protected\def\sphinxcode#1{\fcolorbox[gray]{1}{0.9}{\texttt{#1}}}
Why 0.9 and not 0.95 like the VerbatimColor above? I would expect the same
color here.
Michael
> +
> \makeatother
>
> % vim:syntax=tex
> --
> 2.28.0
>
>
> _______________________________________________
> ptxdist mailing list
> ptxdist@pengutronix.de
> To unsubscribe, send a mail with subject "unsubscribe" to ptxdist-request@pengutronix.de
>
--
Pengutronix e.K. | |
Steuerwalder Str. 21 | http://www.pengutronix.de/ |
31137 Hildesheim, Germany | Phone: +49-5121-206917-0 |
Amtsgericht Hildesheim, HRA 2686 | Fax: +49-5121-206917-5555 |
_______________________________________________
ptxdist mailing list
ptxdist@pengutronix.de
To unsubscribe, send a mail with subject "unsubscribe" to ptxdist-request@pengutronix.de
^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: [ptxdist] [PATCH] doc: highlight inline code with gray box
2020-09-11 10:01 ` Michael Olbrich
@ 2020-09-11 10:07 ` Enrico Jörns
2020-09-11 10:08 ` Michael Olbrich
0 siblings, 1 reply; 4+ messages in thread
From: Enrico Jörns @ 2020-09-11 10:07 UTC (permalink / raw)
To: Michael Olbrich, ptxdist
Am Freitag, den 11.09.2020, 12:01 +0200 schrieb Michael Olbrich:
> On Fri, Sep 11, 2020 at 11:23:31AM +0200, Enrico Jorns wrote:
> > This should ease distinguishing inline code snippets from default text
> > and is also more similar to what the sphinx html outputs look like.
> >
> > Signed-off-by: Enrico Jorns <ejo@pengutronix.de>
> > ---
> > doc/preamble.inc | 3 +++
> > 1 file changed, 3 insertions(+)
> >
> > diff --git a/doc/preamble.inc b/doc/preamble.inc
> > index d9e528ef4..3131987af 100644
> > --- a/doc/preamble.inc
> > +++ b/doc/preamble.inc
> > @@ -82,6 +82,9 @@
> > \definecolor{VerbatimColor}{gray}{0.95}
> > \definecolor{VerbatimBorderColor}{gray}{0.75}
> >
> > +% override default sphinxcode to display gray-colored box
> > +\protected\def\sphinxcode#1{\fcolorbox[gray]{1}{0.9}{\texttt{#1}}}
>
> Why 0.9 and not 0.95 like the VerbatimColor above? I would expect the same
> color here.
That was my first guess, too. But at least on my screen it turned out
that a quite small box with such a light gray and no darker border
could be overseen.
Thus one alternative would be to use the border here, too. If you like
I can give it a try.
Enrico
> Michael
>
> > +
> > \makeatother
> >
> > % vim:syntax=tex
> > --
> > 2.28.0
> >
> >
> > _______________________________________________
> > ptxdist mailing list
> > ptxdist@pengutronix.de
> > To unsubscribe, send a mail with subject "unsubscribe" to ptxdist-request@pengutronix.de
> >
--
Pengutronix e.K. | Enrico Jörns |
Embedded Linux Consulting & Support | https://www.pengutronix.de/ |
Steuerwalder Str. 21 | Phone: +49-5121-206917-180 |
31137 Hildesheim, Germany | Fax: +49-5121-206917-9 |
_______________________________________________
ptxdist mailing list
ptxdist@pengutronix.de
To unsubscribe, send a mail with subject "unsubscribe" to ptxdist-request@pengutronix.de
^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: [ptxdist] [PATCH] doc: highlight inline code with gray box
2020-09-11 10:07 ` Enrico Jörns
@ 2020-09-11 10:08 ` Michael Olbrich
0 siblings, 0 replies; 4+ messages in thread
From: Michael Olbrich @ 2020-09-11 10:08 UTC (permalink / raw)
To: ptxdist
On Fri, Sep 11, 2020 at 12:07:15PM +0200, Enrico Jörns wrote:
> Am Freitag, den 11.09.2020, 12:01 +0200 schrieb Michael Olbrich:
> > On Fri, Sep 11, 2020 at 11:23:31AM +0200, Enrico Jorns wrote:
> > > This should ease distinguishing inline code snippets from default text
> > > and is also more similar to what the sphinx html outputs look like.
> > >
> > > Signed-off-by: Enrico Jorns <ejo@pengutronix.de>
> > > ---
> > > doc/preamble.inc | 3 +++
> > > 1 file changed, 3 insertions(+)
> > >
> > > diff --git a/doc/preamble.inc b/doc/preamble.inc
> > > index d9e528ef4..3131987af 100644
> > > --- a/doc/preamble.inc
> > > +++ b/doc/preamble.inc
> > > @@ -82,6 +82,9 @@
> > > \definecolor{VerbatimColor}{gray}{0.95}
> > > \definecolor{VerbatimBorderColor}{gray}{0.75}
> > >
> > > +% override default sphinxcode to display gray-colored box
> > > +\protected\def\sphinxcode#1{\fcolorbox[gray]{1}{0.9}{\texttt{#1}}}
> >
> > Why 0.9 and not 0.95 like the VerbatimColor above? I would expect the same
> > color here.
>
> That was my first guess, too. But at least on my screen it turned out
> that a quite small box with such a light gray and no darker border
> could be overseen.
> Thus one alternative would be to use the border here, too. If you like
> I can give it a try.
I think I'd prefer that. The different colors look strange to me.
Michael
--
Pengutronix e.K. | |
Steuerwalder Str. 21 | http://www.pengutronix.de/ |
31137 Hildesheim, Germany | Phone: +49-5121-206917-0 |
Amtsgericht Hildesheim, HRA 2686 | Fax: +49-5121-206917-5555 |
_______________________________________________
ptxdist mailing list
ptxdist@pengutronix.de
To unsubscribe, send a mail with subject "unsubscribe" to ptxdist-request@pengutronix.de
^ permalink raw reply [flat|nested] 4+ messages in thread
end of thread, other threads:[~2020-09-11 10:08 UTC | newest]
Thread overview: 4+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2020-09-11 9:23 [ptxdist] [PATCH] doc: highlight inline code with gray box Enrico Jorns
2020-09-11 10:01 ` Michael Olbrich
2020-09-11 10:07 ` Enrico Jörns
2020-09-11 10:08 ` Michael Olbrich
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox