Maybe we change the default black background to something less annoying? it really distracts from reading.
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@lists.freeswitch.org [mailto:freeswitch- docs-bounces@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@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
If it is possible at all, let's disable the "special cut and paste" mechanism, that gets in the way and mostly works poorly. We're all able to do "normal" cut and paste, don't we? -giovanni sent from my mobile, Giovanni Maruzzelli cell: +39 347 266 56 18 On Jun 14, 2015 6:00 PM, "Bote Man" <bote_radio@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@lists.freeswitch.org [mailto:freeswitch- docs-bounces@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@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
_______________________________________________ Freeswitch-docs mailing list Freeswitch-docs@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
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@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@lists.freeswitch.org [mailto:freeswitch- docs-bounces@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@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
_______________________________________________ Freeswitch-docs mailing list Freeswitch-docs@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
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@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@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@lists.freeswitch.org [mailto:freeswitch- docs-bounces@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@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
_______________________________________________ Freeswitch-docs mailing list Freeswitch-docs@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
_______________________________________________ Freeswitch-docs mailing list Freeswitch-docs@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
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@lists.freeswitch.org [mailto:freeswitch-docs-bounces@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@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@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@lists.freeswitch.org [mailto:freeswitch- docs-bounces@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@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs _______________________________________________ Freeswitch-docs mailing list Freeswitch-docs@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs _______________________________________________ Freeswitch-docs mailing list Freeswitch-docs@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
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@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@lists.freeswitch.org [mailto:freeswitch-docs-bounces@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@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@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@lists.freeswitch.org [mailto:freeswitch- docs-bounces@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@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
_______________________________________________ Freeswitch-docs mailing list Freeswitch-docs@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
_______________________________________________ Freeswitch-docs mailing list Freeswitch-docs@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
_______________________________________________ Freeswitch-docs mailing list Freeswitch-docs@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
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@lists.freeswitch.org [mailto:freeswitch- docs-bounces@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@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@lists.freeswitch.org [mailto:freeswitch-docs-bounces@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@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@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@lists.freeswitch.org [mailto:freeswitch- docs-bounces@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@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
_______________________________________________ Freeswitch-docs mailing list Freeswitch-docs@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
_______________________________________________ Freeswitch-docs mailing list Freeswitch-docs@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
_______________________________________________ Freeswitch-docs mailing list Freeswitch-docs@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
_______________________________________________ Freeswitch-docs mailing list Freeswitch-docs@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
or just make a backup and roll back if needed :) On Mon, Jun 15, 2015 at 4:17 PM, Bote Man <bote_radio@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@lists.freeswitch.org [mailto:freeswitch- docs-bounces@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@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@lists.freeswitch.org [mailto:freeswitch-docs-bounces@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@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@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@lists.freeswitch.org [mailto:freeswitch- docs-bounces@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@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
_______________________________________________ Freeswitch-docs mailing list Freeswitch-docs@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
_______________________________________________ Freeswitch-docs mailing list Freeswitch-docs@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
_______________________________________________ Freeswitch-docs mailing list Freeswitch-docs@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
_______________________________________________ Freeswitch-docs mailing list Freeswitch-docs@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
_______________________________________________ Freeswitch-docs mailing list Freeswitch-docs@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
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@lists.freeswitch.org [mailto:freeswitch- docs-bounces@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@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@lists.freeswitch.org [mailto:freeswitch- docs-bounces@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@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@lists.freeswitch.org [mailto:freeswitch-docs-bounces@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@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@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@lists.freeswitch.org [mailto:freeswitch- docs-bounces@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@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
_______________________________________________ Freeswitch-docs mailing list Freeswitch-docs@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
_______________________________________________ Freeswitch-docs mailing list Freeswitch-docs@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
_______________________________________________ Freeswitch-docs mailing list Freeswitch-docs@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
_______________________________________________ Freeswitch-docs mailing list Freeswitch-docs@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
_______________________________________________ Freeswitch-docs mailing list Freeswitch-docs@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
_______________________________________________ Freeswitch-docs mailing list Freeswitch-docs@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
I have OS X 10.6-10.10 (safari), Linux (firefox), Windows XP (firefox and IE), and even…. OS/2 browsers. Remember you can’t please all of the people all of the time. Although I prefer the fonts I listed I can certainly live with what we have. Balance the wiki visual appearance with complexity and maintenance….. Mario
On Jun 15, 2015, at 7:33 AM, Bote Man <bote_radio@botecomm.com> wrote:
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@lists.freeswitch.org [mailto:freeswitch- docs-bounces@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@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@lists.freeswitch.org [mailto:freeswitch- docs-bounces@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@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@lists.freeswitch.org [mailto:freeswitch-docs-bounces@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@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@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@lists.freeswitch.org [mailto:freeswitch- docs-bounces@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@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
_______________________________________________ Freeswitch-docs mailing list Freeswitch-docs@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
_______________________________________________ Freeswitch-docs mailing list Freeswitch-docs@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
_______________________________________________ Freeswitch-docs mailing list Freeswitch-docs@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
_______________________________________________ Freeswitch-docs mailing list Freeswitch-docs@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
_______________________________________________ Freeswitch-docs mailing list Freeswitch-docs@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
_______________________________________________ Freeswitch-docs mailing list Freeswitch-docs@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
_______________________________________________ Freeswitch-docs mailing list Freeswitch-docs@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
Is there a possibility to select the default theme from some predefined ones, without touching CSS? On Jun 15, 2015 4:33 PM, "Bote Man" <bote_radio@botecomm.com> wrote:
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@lists.freeswitch.org [mailto:freeswitch- docs-bounces@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@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@lists.freeswitch.org [mailto: freeswitch- docs-bounces@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@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@lists.freeswitch.org [mailto:freeswitch-docs-bounces@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@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@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@lists.freeswitch.org [mailto:freeswitch- docs-bounces@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@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
_______________________________________________ Freeswitch-docs mailing list Freeswitch-docs@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
_______________________________________________ Freeswitch-docs mailing list Freeswitch-docs@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
_______________________________________________ Freeswitch-docs mailing list Freeswitch-docs@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
_______________________________________________ Freeswitch-docs mailing list Freeswitch-docs@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
_______________________________________________ Freeswitch-docs mailing list Freeswitch-docs@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
_______________________________________________ Freeswitch-docs mailing list Freeswitch-docs@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
_______________________________________________ Freeswitch-docs mailing list Freeswitch-docs@lists.freeswitch.org http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
participants (4)
-
Bote Man
-
Giovanni Maruzzelli
-
Mario
-
Stanislav Sinyagin