emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
* [PATCH] Apply emacs manual css to org pages
@ 2020-12-23  2:35 TEC
  2020-12-23  3:42 ` Greg Minshall
                   ` (3 more replies)
  0 siblings, 4 replies; 12+ messages in thread
From: TEC @ 2020-12-23  2:35 UTC (permalink / raw)
  To: org-mode-email

[-- Attachment #1: Type: text/plain, Size: 356 bytes --]

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


[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: 0001-mk-default.mk-use-same-html-doc-style-as-emacs.patch --]
[-- Type: text/x-patch, Size: 826 bytes --]

From fc57ea88432ea119d063906cc29cc51ee591031d Mon Sep 17 00:00:00 2001
From: TEC <tec@tecosaur.com>
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


^ permalink raw reply related	[flat|nested] 12+ messages in thread

* Re: [PATCH] Apply emacs manual css to org pages
  2020-12-23  2:35 [PATCH] Apply emacs manual css to org pages TEC
@ 2020-12-23  3:42 ` Greg Minshall
  2021-04-25  3:36   ` Timothy
  2020-12-27 15:51 ` Amin Bandali
                   ` (2 subsequent siblings)
  3 siblings, 1 reply; 12+ messages in thread
From: Greg Minshall @ 2020-12-23  3:42 UTC (permalink / raw)
  To: TEC; +Cc: org-mode-email

Timothy,

> This is a quick patch to use the Emacs manual CSS with our generated Org
> manual.

that's certainly visually pleasing.  nice!

Greg


^ permalink raw reply	[flat|nested] 12+ messages in thread

* Re: [PATCH] Apply emacs manual css to org pages
  2020-12-23  2:35 [PATCH] Apply emacs manual css to org pages TEC
  2020-12-23  3:42 ` Greg Minshall
@ 2020-12-27 15:51 ` Amin Bandali
  2020-12-27 21:29 ` Samuel Wales
  2020-12-29  6:07 ` Kyle Meyer
  3 siblings, 0 replies; 12+ messages in thread
From: Amin Bandali @ 2020-12-27 15:51 UTC (permalink / raw)
  To: TEC; +Cc: org-mode-email

[-- Attachment #1: Type: text/plain, Size: 610 bytes --]

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

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 857 bytes --]

^ permalink raw reply	[flat|nested] 12+ messages in thread

* Re: [PATCH] Apply emacs manual css to org pages
  2020-12-23  2:35 [PATCH] Apply emacs manual css to org pages TEC
  2020-12-23  3:42 ` Greg Minshall
  2020-12-27 15:51 ` Amin Bandali
@ 2020-12-27 21:29 ` Samuel Wales
  2020-12-27 21:39   ` Samuel Wales
  2020-12-29  6:07 ` Kyle Meyer
  3 siblings, 1 reply; 12+ messages in thread
From: Samuel Wales @ 2020-12-27 21:29 UTC (permalink / raw)
  To: TEC; +Cc: org-mode-email

i like the black bg, the no issues with paragraph width.


On 12/22/20, TEC <tecosaur@gmail.com> 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


^ permalink raw reply	[flat|nested] 12+ messages in thread

* Re: [PATCH] Apply emacs manual css to org pages
  2020-12-27 21:29 ` Samuel Wales
@ 2020-12-27 21:39   ` Samuel Wales
  2020-12-27 21:45     ` Samuel Wales
  0 siblings, 1 reply; 12+ messages in thread
From: Samuel Wales @ 2020-12-27 21:39 UTC (permalink / raw)
  To: TEC; +Cc: org-mode-email

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 <samologist@gmail.com> wrote:
> i like the black bg, the no issues with paragraph width.
>
>
> On 12/22/20, TEC <tecosaur@gmail.com> 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


^ permalink raw reply	[flat|nested] 12+ messages in thread

* Re: [PATCH] Apply emacs manual css to org pages
  2020-12-27 21:39   ` Samuel Wales
@ 2020-12-27 21:45     ` Samuel Wales
  2020-12-28  4:04       ` TEC
  0 siblings, 1 reply; 12+ messages in thread
From: Samuel Wales @ 2020-12-27 21:45 UTC (permalink / raw)
  To: TEC; +Cc: org-mode-email

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 <samologist@gmail.com> 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 <samologist@gmail.com> wrote:
>> i like the black bg, the no issues with paragraph width.
>>
>>
>> On 12/22/20, TEC <tecosaur@gmail.com> 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


^ permalink raw reply	[flat|nested] 12+ messages in thread

* Re: [PATCH] Apply emacs manual css to org pages
  2020-12-27 21:45     ` Samuel Wales
@ 2020-12-28  4:04       ` TEC
  2020-12-28  4:31         ` Samuel Wales
  0 siblings, 1 reply; 12+ messages in thread
From: TEC @ 2020-12-28  4:04 UTC (permalink / raw)
  To: Samuel Wales; +Cc: org-mode-email


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 <samologist@gmail.com> 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 <samologist@gmail.com> 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 <samologist@gmail.com> wrote:
>>> i like the black bg, the no issues with paragraph width.
>>>
>>>
>>> On 12/22/20, TEC <tecosaur@gmail.com> 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
>>



^ permalink raw reply	[flat|nested] 12+ messages in thread

* Re: [PATCH] Apply emacs manual css to org pages
  2020-12-28  4:04       ` TEC
@ 2020-12-28  4:31         ` Samuel Wales
  0 siblings, 0 replies; 12+ messages in thread
From: Samuel Wales @ 2020-12-28  4:31 UTC (permalink / raw)
  To: TEC; +Cc: org-mode-email

yes, presumably some of these topics apply to emacs style.

On 12/27/20, TEC <tecosaur@gmail.com> 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 <samologist@gmail.com> 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 <samologist@gmail.com> 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 <samologist@gmail.com> wrote:
>>>> i like the black bg, the no issues with paragraph width.
>>>>
>>>>
>>>> On 12/22/20, TEC <tecosaur@gmail.com> 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


^ permalink raw reply	[flat|nested] 12+ messages in thread

* Re: [PATCH] Apply emacs manual css to org pages
  2020-12-23  2:35 [PATCH] Apply emacs manual css to org pages TEC
                   ` (2 preceding siblings ...)
  2020-12-27 21:29 ` Samuel Wales
@ 2020-12-29  6:07 ` Kyle Meyer
  2021-03-24  8:08   ` Bastien
  3 siblings, 1 reply; 12+ messages in thread
From: Kyle Meyer @ 2020-12-29  6:07 UTC (permalink / raw)
  To: TEC; +Cc: Bastien, org-mode-email

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.


^ permalink raw reply	[flat|nested] 12+ messages in thread

* Re: [PATCH] Apply emacs manual css to org pages
  2020-12-29  6:07 ` Kyle Meyer
@ 2021-03-24  8:08   ` Bastien
  2021-04-25  3:34     ` Timothy
  0 siblings, 1 reply; 12+ messages in thread
From: Bastien @ 2021-03-24  8:08 UTC (permalink / raw)
  To: Kyle Meyer; +Cc: org-mode-email, TEC

Hi,

Kyle Meyer <kyle@kyleam.com> 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


^ permalink raw reply	[flat|nested] 12+ messages in thread

* Re: [PATCH] Apply emacs manual css to org pages
  2021-03-24  8:08   ` Bastien
@ 2021-04-25  3:34     ` Timothy
  0 siblings, 0 replies; 12+ messages in thread
From: Timothy @ 2021-04-25  3:34 UTC (permalink / raw)
  To: org-mode-email


This was not marked as applied on updates.orgmode.org.
Doing so with the X-Woof-Patch header.

Bastien <bzg@gnu.org> 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,


^ permalink raw reply	[flat|nested] 12+ messages in thread

* Re: [PATCH] Apply emacs manual css to org pages
  2020-12-23  3:42 ` Greg Minshall
@ 2021-04-25  3:36   ` Timothy
  0 siblings, 0 replies; 12+ messages in thread
From: Timothy @ 2021-04-25  3:36 UTC (permalink / raw)
  To: org-mode-email

For some reason updates.orgmode.org registered this as a new patch??
Marking as closed via X-Woof-Patch header.

Greg Minshall <minshall@umich.edu> 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


^ permalink raw reply	[flat|nested] 12+ messages in thread

end of thread, other threads:[~2021-04-25  3:38 UTC | newest]

Thread overview: 12+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2020-12-23  2:35 [PATCH] Apply emacs manual css to org pages TEC
2020-12-23  3:42 ` Greg Minshall
2021-04-25  3:36   ` Timothy
2020-12-27 15:51 ` Amin Bandali
2020-12-27 21:29 ` Samuel Wales
2020-12-27 21:39   ` Samuel Wales
2020-12-27 21:45     ` Samuel Wales
2020-12-28  4:04       ` TEC
2020-12-28  4:31         ` Samuel Wales
2020-12-29  6:07 ` Kyle Meyer
2021-03-24  8:08   ` Bastien
2021-04-25  3:34     ` Timothy

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).