Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Create an "easy to read theme" #1

Open
LightGuard opened this issue Jul 6, 2013 · 5 comments
Open

Create an "easy to read theme" #1

LightGuard opened this issue Jul 6, 2013 · 5 comments

Comments

@LightGuard
Copy link
Member

I present to you two images of a site I just read (perhaps you've read it, very good article BTW):

before

and

after

I think two things are key here, one of which I know we've touch upon

  • Larger font
  • smaller content area

I believe most of the sites out there are doing their readers a huge disservice by having huge content areas and smaller fonts. When you see the two images above which looks like it'll be easier and faster to read? If you said the "before" image, you may want to look at teleprompters (http://en.wikipedia.org/wiki/File:Teleprompter_in_use.jpg). So far none of our stylesheets address this need, we should fix it.

@mojavelinux
Copy link
Member

Here are some other great references for this effort:

@LightGuard
Copy link
Member Author

The readthedocs one is okay, looks like crap on a mobile device though. The first one is nice, but I still think we can do better. 

Sent from Mailbox for iPhone

On Thu, Aug 1, 2013 at 7:13 PM, Dan Allen [email protected]
wrote:

Here are some other great references for this effort:

* https://sphinxtheme-readability.readthedocs.org/en/latest/ - Sphinx Readability Theme

Reply to this email directly or view it on GitHub:
#1 (comment)

@mojavelinux
Copy link
Member

Yeah, the readability needs to be global, not just for the desktop. Though, we can study why they believe it is readable and take whatever lessons we can from it.

I'll also point out a new CSS framework that is focused on mobile first. The interesting thing about this framework is how they handle the table of contents. It's done as a slide in from the side. That could be implemented in Foundation most likely.

In fact, I kind of like their website as a new theme for Asciidoctor.

@LightGuard
Copy link
Member Author

Cardinal is interesting, but by NOT using a preprocessor they're making it harder to reuse, and it doesn't seem like its easy to extend (I only took a quick look) or build upon. However, since it's just CSS, anything they're doing we can do with Foundation. 

Sent from Mailbox for iPhone

On Thu, Aug 1, 2013 at 7:57 PM, Dan Allen [email protected]
wrote:

Yeah, the readability needs to be global, not just for the desktop. Though, we can study why they believe it is readable and take whatever lessons we can from it.
I'll also point out a new CSS framework that is focused on mobile first. The interesting thing about this framework is how they handle the table of contents. It's done as a slide in from the side. That could be implemented in Foundation most likely.

@mojavelinux
Copy link
Member

I think that the default Asciidoctor stylesheet is now the most readable theme I know how to create atm :) If there are any ideas you have about making it more readable, let's look into it!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants