[Freeswitch-docs] Black background in code snippets

[Bote Man]

Yes, of course. But it is not enough for me to view a variety of pages to check them for sanity. Other browsers and other operating systems might present the page differently than what I see here. People will freak out if I make a change that looks OK for me, but others might not see the same thing that I do. That's the tricky part of CSS and why we should keep the changes small and simple. The Confluence help text has many warnings so I want to proceed with caution.

I would like to coordinate with you, Mario, and any others who have many different browsers and operating systems available to get everybody on irc at one time. After I am ready to test a change I will announce it on the irc channel and ask everybody to view a number of pages to see if they look sane. If not, I can roll it back immediately.

This will not be today, I will let you know.

Bote


> -----Original Message-----
> From: freeswitch-docs-bounces at lists.freeswitch.org [mailto:freeswitch-
> docs-bounces at lists.freeswitch.org] On Behalf Of Stanislav Sinyagin
> Sent: Monday, 15 June, 2015 10:24
> To: FreeSWITCH Docs Team
> Subject: Re: [Freeswitch-docs] Black background in code snippets
> 
> or just make a backup and roll back if needed :)
> 
> On Mon, Jun 15, 2015 at 4:17 PM, Bote Man <bote_radio at botecomm.com>
> wrote:
> > This is the introductory help text that worries me:
> >
> > "You can customize the look and feel of Confluence by editing the global
> stylesheet. This will also _overwrite all styles defined in custom global
> themes_.
> > Please note that the custom global stylesheet will not be applied to spaces
> that define their own custom stylesheet or are using a theme."
> >
> > Knowing how obtuse Confluence can be I want to research this to get it
> right so I don't wipe out the style sheet for the entire site, although I see a
> change I made a few months ago to make text wrap inside the code snippet
> macros and it didn't seem to affect everything else in Confluence. I just don't
> trust it any farther than I can throw it.
> >
> > Since today is already spoken for I won't be able to mess with this right
> away. The Confluence user help forums can often provide a wealth of
> information so that's where I will start.
> >
> > Bote
> >
> >
> >
> >> -----Original Message-----
> >> From: freeswitch-docs-bounces at lists.freeswitch.org [mailto:freeswitch-
> >> docs-bounces at lists.freeswitch.org] On Behalf Of Stanislav Sinyagin
> >> Sent: Monday, 15 June, 2015 10:01
> >> To: FreeSWITCH Docs Team
> >> Subject: Re: [Freeswitch-docs] Black background in code snippets
> >>
> >> Monospace is completely fine -- probably it makes sense to make the
> >> default font one size point smaller.
> >>
> >> I just want a readable document, as it's not a terminal screen and not
> >> a Emacs window (I actually use Emacs, but with white background and
> >> syntax hiliting turned off :-)
> >>
> >> Also it would be cool to have it printer-friendly, although it's
> >> ridiculous to print those pages out :)
> >>
> >>
> >>
> >> On Mon, Jun 15, 2015 at 3:57 PM, Bote Man
> <bote_radio at botecomm.com>
> >> wrote:
> >> > I don’t know what fonts we have available.
> >> >
> >> >
> >> >
> >> > Plus, each operating system and browser family has its own different
> set of
> >> > fonts only some of which intersect.
> >> >
> >> >
> >> >
> >> > Confluence limits what we can do, so don’t get your hopes too high. It’s
> a
> >> > blunt instrument.
> >> >
> >> >
> >> >
> >> > Bote
> >> >
> >> >
> >> >
> >> >
> >> >
> >> > From: freeswitch-docs-bounces at lists.freeswitch.org
> >> > [mailto:freeswitch-docs-bounces at lists.freeswitch.org] On Behalf Of
> Mario
> >> > Sent: Sunday, 14 June, 2015 14:44
> >> > To: FreeSWITCH Docs Team
> >> > Subject: Re: [Freeswitch-docs] Black background in code snippets
> >> >
> >> >
> >> >
> >> > Another possibility to provide better reading is to use a thicker font
> >> > without serifs for the white letters. Keep in mind that on terminal
> sessions
> >> > the letters are typically monospaced. Below are what it looks like now
> and a
> >> > a couple of samples to demonstrate, I kept the point since the same
> (14)
> >> but
> >> > notice how they still take the same space. I wrote many computer
> books
> >> for
> >> > classes and had a lot of experience testing fonts and found non-serif
> best
> >> > for commands/etc.
> >> >
> >> >
> >> >
> >> > Current what I see now in Confluence - Courier New (note serifs):
> >> >
> >> > sudo chown -R yourname:yourgroup local    # Modify the owner of the
> >> > /usr/local directory to yours
> >> >
> >> >
> >> >
> >> > Andale Mono (no serifs):
> >> >
> >> > sudo chown -R yourname:yourgroup local    # Modify the owner of the
> >> > /usr/local directory to yours
> >> >
> >> >
> >> >
> >> > Monaco (I use this a lot in books for this purpose):
> >> >
> >> > sudo chown -R yourname:yourgroup local    # Modify the owner of the
> >> > /usr/local directory to yours
> >> >
> >> >
> >> >
> >> > Mario G
> >> >
> >> >
> >> >
> >> >
> >> >
> >> > On Jun 14, 2015, at 11:24 AM, Stanislav Sinyagin <ssinyagin at gmail.com>
> >> > wrote:
> >> >
> >> >
> >> >
> >> > the problem is, that the black code snippets pop out and my eyes have
> >> > difficulty to actually detect the text on the page -- especially if
> >> > there are lots of code snippets. The brain gets too much distraction
> >> > and it's difficult to find the desired part on the screen.
> >> >
> >> > The old wiki had a light-grey background for source code, and that was
> >> > quite perfect.
> >> >
> >> >
> >> > On Sun, Jun 14, 2015 at 6:00 PM, Bote Man
> <bote_radio at botecomm.com>
> >> wrote:
> >> >
> >> > Really, it is the contrast between white characters and black
> background. I
> >> > simply chose that emacs theme to emulate a "glass tty", and Anthony is
> a
> >> > huge emacs fan.
> >> >
> >> > All the other choices are either black or white background, so not much
> >> > choice. It's nice to make it stand out from narrative text, however.
> >> >
> >> > We could change the style sheet if I can ever figure out how. I haven't
> >> > pursued it because there is a warning in the help about superseding
> >> > everything else. I don't know if they mean it supersedes the affected
> >> > element across the whole Confluence site or if it wipes out the entire
> style
> >> > sheet except for the changes. Knowing how stupid Confluence can be in
> >> other
> >> > areas I wouldn't be surprised if it's the latter.
> >> >
> >> > I'll see about a soft charcoal color, or maybe a baby blue. :-)
> >> >
> >> > Bote
> >> >
> >> >
> >> >
> >> >
> >> >
> >> > -----Original Message-----
> >> > From: freeswitch-docs-bounces at lists.freeswitch.org
> [mailto:freeswitch-
> >> > docs-bounces at lists.freeswitch.org] On Behalf Of Stanislav Sinyagin
> >> > Sent: Sunday, 14 June, 2015 10:35
> >> > To: FreeSWITCH Docs Team
> >> > Subject: [Freeswitch-docs] Black background in code snippets
> >> >
> >> > Maybe we change the default black background to something less
> >> > annoying? it really distracts from reading.
> >> >
> >> > _______________________________________________
> >> > Freeswitch-docs mailing list
> >> > Freeswitch-docs at lists.freeswitch.org
> >> > http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
> >> >
> >> >
> >> >
> >> > _______________________________________________
> >> > Freeswitch-docs mailing list
> >> > Freeswitch-docs at lists.freeswitch.org
> >> > http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
> >> >
> >> >
> >> > _______________________________________________
> >> > Freeswitch-docs mailing list
> >> > Freeswitch-docs at lists.freeswitch.org
> >> > http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
> >> >
> >> >
> >> >
> >> >
> >> > _______________________________________________
> >> > Freeswitch-docs mailing list
> >> > Freeswitch-docs at lists.freeswitch.org
> >> > http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
> >> >
> >>
> >> _______________________________________________
> >> Freeswitch-docs mailing list
> >> Freeswitch-docs at lists.freeswitch.org
> >> http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
> >
> >
> > _______________________________________________
> > Freeswitch-docs mailing list
> > Freeswitch-docs at lists.freeswitch.org
> > http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
> 
> _______________________________________________
> Freeswitch-docs mailing list
> Freeswitch-docs at lists.freeswitch.org
> http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs