Re: [PATCH] Apply emacs manual css to org pages
For some reason updates.orgmode.org registered this as a new patch?? Marking as closed via X-Woof-Patch header. Greg Minshall writes: > Timothy, > >> This is a quick patch to use the Emacs manual CSS with our generated Org >> manual. > > that's certainly visually pleasing. nice! > > Greg
Re: [PATCH] Apply emacs manual css to org pages
This was not marked as applied on updates.orgmode.org. Doing so with the X-Woof-Patch header. Bastien writes: > I made this change and tested it online, the HTML Org manual now looks > like the Emacs manual: https://orgmode.org/manual/ > > Thanks for the suggestion! > In any cas, the Emacs manual css is better than my attempt and using > it for Org makes sense IMO. > > Best,
Re: [PATCH] Apply emacs manual css to org pages
Hi, Kyle Meyer writes: >> # How to create the HTML file >> -TEXI2HTML = makeinfo --html --number-sections >> +TEXI2HTML = makeinfo --html --number-sections --css-ref >> "https://www.gnu.org/software/emacs/manual.css; I made this change and tested it online, the HTML Org manual now looks like the Emacs manual: https://orgmode.org/manual/ Thanks for the suggestion! > Hmm, while I barely ever look at the online manual, I thought I recalled > it having custom styling, and indeed it looks like that was the case: > > https://web.archive.org/web/20171222052224/https://orgmode.org/org.html > > At least based on the Wayback Machine rendering, it seems like the > custom CSS was lost shortly after the snapshot above. > > If you look in the repo for org-manual.css, you can see there is still > handling for it. Yes, I remember I tried to enhance the css for the manual, and I don't remember why this change was reverted. > So, if we're going to go in the direction of this patch, there should be > some mention of the previous approach, why it was dropped, and the > handling for org-manual.css should probably be removed. Perhaps Bastien > can help fill in some details here. In any cas, the Emacs manual css is better than my attempt and using it for Org makes sense IMO. Best, -- Bastien
Re: [PATCH] Apply emacs manual css to org pages
TEC writes: > Subject: [PATCH] mk/default.mk: use same html doc style as emacs > > * mk/default.mk: Add CSS stylesheet ref to HTML generated by TEXI2HTML, > specifically the stylesheet used with the online Emacs manual. > --- > mk/default.mk | 2 +- > 1 file changed, 1 insertion(+), 1 deletion(-) > > diff --git a/mk/default.mk b/mk/default.mk > index fbfdaf5..e92d58c 100644 > --- a/mk/default.mk > +++ b/mk/default.mk > @@ -139,7 +139,7 @@ MKDIR = install -m 755 -d > MAKEINFO = makeinfo > > # How to create the HTML file > -TEXI2HTML = makeinfo --html --number-sections > +TEXI2HTML = makeinfo --html --number-sections --css-ref > "https://www.gnu.org/software/emacs/manual.css; Hmm, while I barely ever look at the online manual, I thought I recalled it having custom styling, and indeed it looks like that was the case: https://web.archive.org/web/20171222052224/https://orgmode.org/org.html At least based on the Wayback Machine rendering, it seems like the custom CSS was lost shortly after the snapshot above. If you look in the repo for org-manual.css, you can see there is still handling for it. So, if we're going to go in the direction of this patch, there should be some mention of the previous approach, why it was dropped, and the handling for org-manual.css should probably be removed. Perhaps Bastien can help fill in some details here.
Re: [PATCH] Apply emacs manual css to org pages
yes, presumably some of these topics apply to emacs style. On 12/27/20, TEC wrote: > > Hi Samuel, > > We could add some of our own CSS, but that would have us deviate from > the Emacs manual. It's worth asking if we want to do that IMO. > > -- > Timothy > > Samuel Wales writes: > >> i wonder if css makes it possible to have wider margins /except/ for >> tables and stuch. or perhaps that is consiedered bad style. but it >> would be accessible/functional. but i am just glad that it is only >> tables that need horizontal scrolling. >> >> On 12/27/20, Samuel Wales wrote: >>> if i were to make any /tiny nit-level/ suggestions from my pov it >>> would be somewhat wider margins, not pure white but slightly [so still >>> /very/ high contrast] warmer for fg, and some less-blue for links [but >>> i realize blue is common]. >>> >>> i would also do [ha ha, as if i knew what to do or even whether it is >>> possible] wrapping for left columns that go under text rather than >>> bullet for e.g this line: "• Extracting Agenda Information >>> Post-processing agenda information." set fonts large. >>> >>> these are without regard for emacs manual as i have not seen that >>> online recently. great job. thank you. >>> >>> >>> On 12/27/20, Samuel Wales wrote: i like the black bg, the no issues with paragraph width. On 12/22/20, TEC wrote: > Hi all, > > This is a quick patch to use the Emacs manual CSS with our generated > Org > manual. > > You can see what the single-page version of this looks like here: > https://tecosaur.com/resources/org/doc/manual.html and the multi-page > here: https://tecosaur.com/resources/org/doc/manual/ > > This should be an easy upgrade to our online documentation :) > > -- > Timothy > > -- The Kafka Pandemic Please learn what misopathy is. https://thekafkapandemic.blogspot.com/2013/10/why-some-diseases-are-wronged.html >>> >>> >>> -- >>> The Kafka Pandemic >>> >>> Please learn what misopathy is. >>> https://thekafkapandemic.blogspot.com/2013/10/why-some-diseases-are-wronged.html >>> > > -- The Kafka Pandemic Please learn what misopathy is. https://thekafkapandemic.blogspot.com/2013/10/why-some-diseases-are-wronged.html
Re: [PATCH] Apply emacs manual css to org pages
Hi Samuel, We could add some of our own CSS, but that would have us deviate from the Emacs manual. It's worth asking if we want to do that IMO. -- Timothy Samuel Wales writes: > i wonder if css makes it possible to have wider margins /except/ for > tables and stuch. or perhaps that is consiedered bad style. but it > would be accessible/functional. but i am just glad that it is only > tables that need horizontal scrolling. > > On 12/27/20, Samuel Wales wrote: >> if i were to make any /tiny nit-level/ suggestions from my pov it >> would be somewhat wider margins, not pure white but slightly [so still >> /very/ high contrast] warmer for fg, and some less-blue for links [but >> i realize blue is common]. >> >> i would also do [ha ha, as if i knew what to do or even whether it is >> possible] wrapping for left columns that go under text rather than >> bullet for e.g this line: "• Extracting Agenda Information >> Post-processing agenda information." set fonts large. >> >> these are without regard for emacs manual as i have not seen that >> online recently. great job. thank you. >> >> >> On 12/27/20, Samuel Wales wrote: >>> i like the black bg, the no issues with paragraph width. >>> >>> >>> On 12/22/20, TEC wrote: Hi all, This is a quick patch to use the Emacs manual CSS with our generated Org manual. You can see what the single-page version of this looks like here: https://tecosaur.com/resources/org/doc/manual.html and the multi-page here: https://tecosaur.com/resources/org/doc/manual/ This should be an easy upgrade to our online documentation :) -- Timothy >>> >>> >>> -- >>> The Kafka Pandemic >>> >>> Please learn what misopathy is. >>> https://thekafkapandemic.blogspot.com/2013/10/why-some-diseases-are-wronged.html >>> >> >> >> -- >> The Kafka Pandemic >> >> Please learn what misopathy is. >> https://thekafkapandemic.blogspot.com/2013/10/why-some-diseases-are-wronged.html >>
Re: [PATCH] Apply emacs manual css to org pages
i wonder if css makes it possible to have wider margins /except/ for tables and stuch. or perhaps that is consiedered bad style. but it would be accessible/functional. but i am just glad that it is only tables that need horizontal scrolling. On 12/27/20, Samuel Wales wrote: > if i were to make any /tiny nit-level/ suggestions from my pov it > would be somewhat wider margins, not pure white but slightly [so still > /very/ high contrast] warmer for fg, and some less-blue for links [but > i realize blue is common]. > > i would also do [ha ha, as if i knew what to do or even whether it is > possible] wrapping for left columns that go under text rather than > bullet for e.g this line: "• Extracting Agenda Information > Post-processing agenda information." set fonts large. > > these are without regard for emacs manual as i have not seen that > online recently. great job. thank you. > > > On 12/27/20, Samuel Wales wrote: >> i like the black bg, the no issues with paragraph width. >> >> >> On 12/22/20, TEC wrote: >>> Hi all, >>> >>> This is a quick patch to use the Emacs manual CSS with our generated Org >>> manual. >>> >>> You can see what the single-page version of this looks like here: >>> https://tecosaur.com/resources/org/doc/manual.html and the multi-page >>> here: https://tecosaur.com/resources/org/doc/manual/ >>> >>> This should be an easy upgrade to our online documentation :) >>> >>> -- >>> Timothy >>> >>> >> >> >> -- >> The Kafka Pandemic >> >> Please learn what misopathy is. >> https://thekafkapandemic.blogspot.com/2013/10/why-some-diseases-are-wronged.html >> > > > -- > The Kafka Pandemic > > Please learn what misopathy is. > https://thekafkapandemic.blogspot.com/2013/10/why-some-diseases-are-wronged.html > -- The Kafka Pandemic Please learn what misopathy is. https://thekafkapandemic.blogspot.com/2013/10/why-some-diseases-are-wronged.html
Re: [PATCH] Apply emacs manual css to org pages
if i were to make any /tiny nit-level/ suggestions from my pov it would be somewhat wider margins, not pure white but slightly [so still /very/ high contrast] warmer for fg, and some less-blue for links [but i realize blue is common]. i would also do [ha ha, as if i knew what to do or even whether it is possible] wrapping for left columns that go under text rather than bullet for e.g this line: "• Extracting Agenda Information Post-processing agenda information." set fonts large. these are without regard for emacs manual as i have not seen that online recently. great job. thank you. On 12/27/20, Samuel Wales wrote: > i like the black bg, the no issues with paragraph width. > > > On 12/22/20, TEC wrote: >> Hi all, >> >> This is a quick patch to use the Emacs manual CSS with our generated Org >> manual. >> >> You can see what the single-page version of this looks like here: >> https://tecosaur.com/resources/org/doc/manual.html and the multi-page >> here: https://tecosaur.com/resources/org/doc/manual/ >> >> This should be an easy upgrade to our online documentation :) >> >> -- >> Timothy >> >> > > > -- > The Kafka Pandemic > > Please learn what misopathy is. > https://thekafkapandemic.blogspot.com/2013/10/why-some-diseases-are-wronged.html > -- The Kafka Pandemic Please learn what misopathy is. https://thekafkapandemic.blogspot.com/2013/10/why-some-diseases-are-wronged.html
Re: [PATCH] Apply emacs manual css to org pages
i like the black bg, the no issues with paragraph width. On 12/22/20, TEC wrote: > Hi all, > > This is a quick patch to use the Emacs manual CSS with our generated Org > manual. > > You can see what the single-page version of this looks like here: > https://tecosaur.com/resources/org/doc/manual.html and the multi-page > here: https://tecosaur.com/resources/org/doc/manual/ > > This should be an easy upgrade to our online documentation :) > > -- > Timothy > > -- The Kafka Pandemic Please learn what misopathy is. https://thekafkapandemic.blogspot.com/2013/10/why-some-diseases-are-wronged.html
Re: [PATCH] Apply emacs manual css to org pages
Hi Timothy, all, TEC writes: > Hi all, > > This is a quick patch to use the Emacs manual CSS with our generated Org > manual. > > You can see what the single-page version of this looks like here: > https://tecosaur.com/resources/org/doc/manual.html and the multi-page > here: https://tecosaur.com/resources/org/doc/manual/ > > This should be an easy upgrade to our online documentation :) Definite +1 from me. It helps with readability and consistency of the Org manual with the Emacs manual(s) and the manuals of several other GNU packages that use this or a variation of this stylesheet. > -- > Timothy signature.asc Description: PGP signature
Re: [PATCH] Apply emacs manual css to org pages
Timothy, > This is a quick patch to use the Emacs manual CSS with our generated Org > manual. that's certainly visually pleasing. nice! Greg
[PATCH] Apply emacs manual css to org pages
Hi all, This is a quick patch to use the Emacs manual CSS with our generated Org manual. You can see what the single-page version of this looks like here: https://tecosaur.com/resources/org/doc/manual.html and the multi-page here: https://tecosaur.com/resources/org/doc/manual/ This should be an easy upgrade to our online documentation :) -- Timothy >From fc57ea88432ea119d063906cc29cc51ee591031d Mon Sep 17 00:00:00 2001 From: TEC Date: Wed, 23 Dec 2020 10:30:09 +0800 Subject: [PATCH] mk/default.mk: use same html doc style as emacs * mk/default.mk: Add CSS stylesheet ref to HTML generated by TEXI2HTML, specifically the stylesheet used with the online Emacs manual. --- mk/default.mk | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/mk/default.mk b/mk/default.mk index fbfdaf5..e92d58c 100644 --- a/mk/default.mk +++ b/mk/default.mk @@ -139,7 +139,7 @@ MKDIR = install -m 755 -d MAKEINFO = makeinfo # How to create the HTML file -TEXI2HTML = makeinfo --html --number-sections +TEXI2HTML = makeinfo --html --number-sections --css-ref "https://www.gnu.org/software/emacs/manual.css; # How to find files FIND = find -- 2.29.2