Documentation Font Size Solution

Christian Haines's icon

Hi All

This maybe of interest to folks who want to resize the font / interface of the inbuilt documentation.

I was looking around in the forums for a way to resize the inbuilt Max documentation. Since I couldn't find a solution amongst the forum community I started looking around the Max application strings, preferences and application bundle on OSX. I discovered that the Max documentation renderer uses information in a folder called "unibrowser". Inside this folder is a CSS style sheet which controls much (all?) of how the documentation is rendered.

  • To access the style sheet on OSX right click the application Max and select show "Show Package Contents".

  • Navigate to the folder "Contents > Resources > C74 > docs > unibrowser > css".

  • Inside the folder is a CSS stylesheet called "theme.min.css".

  • Open this in a text editor and you can see many many different style sheet attributes.

  • The simplest way to globally resize all the fonts is to add the line "* {font-size: 102% !important; }" and relaunch the Max Documentation Reference.

  • Adding the line "* {zoom: 102% !important;}" will zoom everything - fonts, images, containers etc

A few notes:

  • It needs more work, probably targeting more attributes with specific sizes

  • I've only tried this on OSX - maybe some other folks could confirm it works on Windows?

  • "theme.min.css" is difficult to read as it is a heavily minimised CSS file with carriage returns missing. You can use an online CSS format tool, like http://www.cleancss.com/css-beautify/, to make it readable

  • Given that it is changing a file in the application bundle, it is best to keep a backup elsewhere on your computer for when Max gets updated so you can replace the changed file

  • I can't see a way to change the left navigation font size

  • I'd imagine it would be possible for those with time to write an extra which dynamically rewrites the style sheet with key commands and relaunches the file - AKA zoom keycommands

Hope this helps someone.

Best

al808's icon

Thanks Christian, that was very useful.
Cheers Al.

Bill 2's icon

Well done, Christian! Like me, you seem to've felt the need to change the text in the documentation. I do something much more basic, but it's still effective enough to help my old eyes: I use the online documentation instead of what's in the app itself; that way Command+ and Command- change the font size. Cheers, Bill

jonah's icon

you can also open the documentation in jweb object. slightly blurry or something (although if you made it bigger and zoomed out...) and you loose the ability to drag objects from it into patch - which woulda been pretty neat because then you could make a document with objects you use a lot and drag them in - but i found it useful to have more than one reference open at a time.

maybe in combination with adjusting the css it could be useful to you though...

RmaN J's icon

Thanks Man :)

TO ADD ON THAT , this CSS file is EXACTLY the css used on Online Max 7 documentation Pages example :

so you can basically inspect with your browser or your web dev tools and find specifically which part is which !

i noticed the main text (which i mainly needed it to be zoomed) is p tags (paragraph) , i tested :

p {
font-size : 20px ;
}

when it worked in browser i copied it in the end of theme.min.css file and worked in the offline documentation as well !

after all the online documentation is just a web view so you can basically edit it whatever you like (which is soo coool !)

grymmjack's icon

This was super helpful. I wanted to share how I made it more readable for me.

The complete lack of attention to usability in 2016 is mind boggling. It's clear the UX designers at Cylcing74 know better, yet they somehow just decided not to allow us to zoom? I mean, there is a Magnifier in the Window menu - which means "hey guys, we know things are small." However, instead of fixing them or allowing us to just zoom in and out as per our preference, everything is rigidly configured and very difficult to see and read. Don't even talk to me about the color choices :)

Anyway thanks to the OP you can simply put this code after the existing theme.min.css stuff and it will make it look like the attached image.

/* make it readable! */
#doc-contents-table {
    width: 300px !important;
}
.docshtml #doc-body.slide-in {
    padding-left: 310px !important;
}
.docshtml #doc-body {
    padding: 24px !important;
}
h1,h2,h3,h4,h5 {
    font-weight: bold;
}
#doc-contents-table .toc-list > li {
    line-height: 24px !important;
}
#doc-body h2 {
    border-bottom: 1px solid #999;
}
#doc-index {
    font-size: 18px !important;
    line-height: 24px !important;
}
html .docshtml #doc-body {
    font-size: 18px !important;
    line-height: 24px !important;
}
* {
    font-size: 18px !important;
}
h1 {
    font-size: 32px !important;
}
#doc-scroll-header * {
    font-size: 13px !important;
}
html a:link {
    color: #0078ff;
}
html a:visited {
    color: #9e31ce !important;
}
html a:hover, html a:focus, html a:active {
    color: #ff7500;
}
html .hilit {
    color: #333;
    font-style: oblique;
}
html img {
    zoom: 120%;
}
html p {
    margin: 24px !important;
}

2017-01-02-23_43_30-Documentation_-Tutorial-1_-Hello.png
png
foldh's icon

"The complete lack of attention to usability in 2016 is mind boggling."

Whilst I'm happy with most of the usability features in Max 7, I agree that the fact that you can't easily change the font size/zoom in on the documentation is pretty poor.

@Cycling74, I hope you will address this in the next Max 7 update.

Cheers

Paul

mheton's icon

great thread.
I wish the cycling74 team would change there font size philosophy regarding the documentation in an upcoming update.

Nicholas Virgo's icon

I'm more than gobsmacked that this continues to be an issue. Not to have changed it in this day and age smacks of rank ignorance. Somebody prove me wrong. I would love to apologise.

Thanks to those above for providing solutions ... hey, but what a faff.

Michael Metcalf's icon

Super late to the party here, but totally agree with most of whats said here. Loving Max but the in-app doc viewer just needs a resize option. I've resorted to just hitting the equivalent docs on the web as needed. https://docs.cycling74.com/max8/tutorials/01_mspintro

bernard's icon

This is no longer relevant in Max 8 as there is no folder called "css" in the given pathway. If anyone has an updated version, please link me. cheers~

Moritz Huber's icon

Now in Max 9 it seems there is still no solution to this?

Christian Haines's icon

Unsurprisingly much has changed in 9 years. Still no documentation font size options, but I get it .. different priorities for the cycling74 team. Looking at it briefly, as I don't have time currently sorry, I can change font sizes for many aspects but not the basefont. I can point to some areas of interest if others want to take up the challenge.

macOS path:

Do a search for font-size reveals a chunk of CSS vars:

root{--c74-font-family: Lato;--c74-font-family-monospace: Menlo,Monaco,"Courier New",Courier,monospace;--c74-monospace-size: .9em;--c74-font-family-patcher: Arial;--c74-font-size-base: 14px;--c74-font-size-xs: .8rem;--c74-font-size-sm: .93rem;--c74-font-size-md: var(--c74-font-size-base);--c74-font-size-lg: 1.2rem;--c74-font-size-xl: 1.6rem;--c74-font-size-title: 2rem;

Some of these effect the documentation fonts but not the basefont as far as I can see.

In the following files it appears some font sizes / controls are dynamically js built. Those with experience with the react js library would have better understanding.

Best of luck.

Moritz Huber's icon

Yes I also get that but it's just strange that such a thing could be hard to implement. But maybe it is. It's just a bit sad this software seems so refined and this one thing makes it much worse for me since i now cant really comfortable use it with my normal display/setup.

I don't have experiance with react but maybe will still look into this. So thanks for the infos.

Moritz Huber's icon

I asked the support about this is planned to be implemented soon or if there is something I could do now, and they responded:
"... some aspects of your request are actively being worked on -- however I do not have a timetable for this work, and would recommend using OS-level display and accessibility settings for this in the meantime."

So to me this does sound like they have this somewhere in there backlog and maybe will get to it when they find time, but it's not important for them. Which is a bit disappointing.

Roman Thilenius's icon

using a smaller display resolution is no option for you?

Roman Thilenius's icon

i have honestly no idea how anyone should be able to read things like that...

...but the font size is not the issue here, it is two other things.