Re: [OT] Usage of U+00B6 PILCROW SIGN (was: generator slides review and Python doc (+/- text bug))

2014-02-06 Thread Rustom Mody
On Tuesday, February 4, 2014 8:51:25 PM UTC+5:30, jmf wrote:

 Useless and really ugly.

Evidently one can do worse:

http://www.pip-installer.org/en/latest/installing.html#requirements
-- 
https://mail.python.org/mailman/listinfo/python-list


Re: [OT] Usage of U+00B6 PILCROW SIGN (was: generator slides review and Python doc (+/- text bug))

2014-02-06 Thread wxjmfauth
Le jeudi 6 février 2014 13:23:03 UTC+1, Rustom Mody a écrit :
 On Tuesday, February 4, 2014 8:51:25 PM UTC+5:30, jmf wrote:
 
 
 
  Useless and really ugly.
 
 
 
 Evidently one can do worse:
 
 
 
 http://www.pip-installer.org/en/latest/installing.html#requirements

or http://cx-freeze.readthedocs.org/en/latest/index.html
-- 
https://mail.python.org/mailman/listinfo/python-list


Re: [OT] Usage of U+00B6 PILCROW SIGN (was: generator slides review and Python doc (+/- text bug))

2014-02-06 Thread Chris Angelico
On Thu, Feb 6, 2014 at 11:23 PM, Rustom Mody rustompm...@gmail.com wrote:
 On Tuesday, February 4, 2014 8:51:25 PM UTC+5:30, jmf wrote:

 Useless and really ugly.

 Evidently one can do worse:

 http://www.pip-installer.org/en/latest/installing.html#requirements

Aside from using a little chain link icon rather than a
typographer's symbol, that looks exactly the same. How's it worse?

ChrisA
-- 
https://mail.python.org/mailman/listinfo/python-list


Re: [OT] Usage of U+00B6 PILCROW SIGN (was: generator slides review and Python doc (+/- text bug))

2014-02-04 Thread Jerry Hill
On Tue, Feb 4, 2014 at 1:51 AM,  wxjmfa...@gmail.com wrote:
 I got it. If I'm visiting a page like this:

 http://docs.python.org/3/tutorial/index.html#the-python-tutorial

 1) To read the page, I'm scrolling down.
 2) When I have finished to read the page, I scroll up
 (or scroll back/up) to the top of the page until I see
 this feature and the title.
 3) I click on this feature.
 4) The title, already visible, moves, let's say, 2cm higher.

 ...?

Those links aren't for navigation.

They're so you can discover anchor links in the page and pass them to
someone else.  For instance, if I want to point someone to the section
of the tutorial that talks about reading and writing files, I could
just give them this link:
http://docs.python.org/3/tutorial/inputoutput.html#reading-and-writing-files,
instead of pointing them to the main page and instructing them to
scroll down until they see Section 7.2

I was able to discover that link by opening the page, highlighting the
section header with my mouse, then clicking the pilcrow.  That gives
me the anchor link to that section header.
-- 
https://mail.python.org/mailman/listinfo/python-list


Re: [OT] Usage of U+00B6 PILCROW SIGN (was: generator slides review and Python doc (+/- text bug))

2014-02-04 Thread wxjmfauth
Le mardi 4 février 2014 15:39:54 UTC+1, Jerry Hill a écrit :
 On Tue, Feb 4, 2014 at 1:51 AM,  wxjmfa...@gmail.com wrote:
 
  I got it. If I'm visiting a page like this:
 
 
 
  http://docs.python.org/3/tutorial/index.html#the-python-tutorial
 
 
 
  1) To read the page, I'm scrolling down.
 
  2) When I have finished to read the page, I scroll up
 
  (or scroll back/up) to the top of the page until I see
 
  this feature and the title.
 
  3) I click on this feature.
 
  4) The title, already visible, moves, let's say, 2cm higher.
 
 
 
  ...?
 
 
 
 Those links aren't for navigation.
 
 
 
 They're so you can discover anchor links in the page and pass them to
 
 someone else.  For instance, if I want to point someone to the section
 
 of the tutorial that talks about reading and writing files, I could
 
 just give them this link:
 
 http://docs.python.org/3/tutorial/inputoutput.html#reading-and-writing-files,
 
 instead of pointing them to the main page and instructing them to
 
 scroll down until they see Section 7.2
 
 
 
 I was able to discover that link by opening the page, highlighting the
 
 section header with my mouse, then clicking the pilcrow.  That gives
 
 me the anchor link to that section header.

Useless and really ugly.

-- 
https://mail.python.org/mailman/listinfo/python-list


Re: [OT] Usage of U+00B6 PILCROW SIGN (was: generator slides review and Python doc (+/- text bug))

2014-02-04 Thread andrea crotti
2014-02-04  wxjmfa...@gmail.com:
 Le mardi 4 février 2014 15:39:54 UTC+1, Jerry Hill a écrit :


 Useless and really ugly.


I think this whole discussion is rather useless instead, why do you
care since you're not going to use this tool anyway?
-- 
https://mail.python.org/mailman/listinfo/python-list


generator slides review and Python doc (+/- text bug)

2014-02-03 Thread wxjmfauth
generator slides review and Python doc


I do not know what tool is used to produce such
slides.

When the mouse is over a a text like a title (H* ... \H* ???)
the text get transformed and a colored eol is appearing.

Example with the slide #3:

Even numbers
becomes
Even numbers§

with a visible colored §, 'SECTION SIGN'


I noticed the same effect with the Python doc
since ? (long time).

Eg. 

The Python Tutorial
appears as 
The Python Tutorial¶

with a visible colored ¶, 'PILCROW SIGN',
blueish in Python 3, red in Python 2.7.6.


And in plenty third party Python docs using
probaly the same tool as the official Python
doc.
The eol glyph may vary and may not be a § or a ¶.

Windows, Firefox and others.

The .chm files do not seem to be affected.

jmf
-- 
https://mail.python.org/mailman/listinfo/python-list


Re: generator slides review and Python doc (+/- text bug)

2014-02-03 Thread Jean-Michel Pichavant
- Original Message -
 generator slides review and Python doc
 
 
 I do not know what tool is used to produce such
 slides.
 
 When the mouse is over a a text like a title (H* ... \H* ???)
 the text get transformed and a colored eol is appearing.

Used to get a link to the given chapter/section...
Works as intended.

Sphinx features the same thing, it can be disabled.

JM

Note : the links provided in the OP example are broken though


-- IMPORTANT NOTICE: 

The contents of this email and any attachments are confidential and may also be 
privileged. If you are not the intended recipient, please notify the sender 
immediately and do not disclose the contents to any other person, use it for 
any purpose, or store or copy the information in any medium. Thank you.
-- 
https://mail.python.org/mailman/listinfo/python-list


Re: generator slides review and Python doc (+/- text bug)

2014-02-03 Thread Michael Torrie
On 02/03/2014 06:59 AM, wxjmfa...@gmail.com wrote:
 generator slides review and Python doc
 
 
 I do not know what tool is used to produce such
 slides.

What slides?  What web site are you referring to?  A little context
wouldn't hurt.
-- 
https://mail.python.org/mailman/listinfo/python-list


Re: generator slides review and Python doc (+/- text bug)

2014-02-03 Thread Rotwang

On 03/02/2014 13:59, wxjmfa...@gmail.com wrote:

[...]

I noticed the same effect with the Python doc
since ? (long time).

Eg.

The Python Tutorial
appears as
The Python Tutorial¶

with a visible colored ¶, 'PILCROW SIGN',
blueish in Python 3, red in Python 2.7.6.


Hint: try clicking the ¶.
--
https://mail.python.org/mailman/listinfo/python-list


Re: generator slides review and Python doc (+/- text bug)

2014-02-03 Thread andrea crotti
2014-02-03  wxjmfa...@gmail.com:
 generator slides review and Python doc


 I do not know what tool is used to produce such
 slides.

 When the mouse is over a a text like a title (H* ... \H* ???)
 the text get transformed and a colored eol is appearing.

 Example with the slide #3:

 Even numbers
 becomes
 Even numbers§

 with a visible colored §, 'SECTION SIGN'


 I noticed the same effect with the Python doc
 since ? (long time).

 Eg.

 The Python Tutorial
 appears as
 The Python Tutorial¶

 with a visible colored ¶, 'PILCROW SIGN',
 blueish in Python 3, red in Python 2.7.6.


 And in plenty third party Python docs using
 probaly the same tool as the official Python
 doc.
 The eol glyph may vary and may not be a § or a ¶.

 Windows, Firefox and others.

 The .chm files do not seem to be affected.

 jmf
 --
 https://mail.python.org/mailman/listinfo/python-list

I just saw now this mail you didn't reply to my email correctly..
Anyway I use this:
https://github.com/nyergler/hieroglyph
And I just use sphinx + RST to generate the slides, the raw source is here:
https://raw2.github.com/AndreaCrotti/generators/master/index.rst
-- 
https://mail.python.org/mailman/listinfo/python-list


Re: generator slides review and Python doc (+/- text bug)

2014-02-03 Thread wxjmfauth
Le lundi 3 février 2014 18:42:36 UTC+1, Rotwang a écrit :
 On 03/02/2014 13:59, wxjmfa...@gmail.com wrote:
 
  [...]
 
 
 
  I noticed the same effect with the Python doc
 
  since ? (long time).
 
 
 
  Eg.
 
 
 
  The Python Tutorial
 
  appears as
 
  The Python Tutorial¶
 
 
 
  with a visible colored ¶, 'PILCROW SIGN',
 
  blueish in Python 3, red in Python 2.7.6
 
 
 
 Hint: try clicking the ¶.

I never was aware of this feature. Is it deliverate?

It gives to me the feeling of a badly programmed
html page, especially if this sign does correspond
to an eol!

jmf
-- 
https://mail.python.org/mailman/listinfo/python-list


Re: generator slides review and Python doc (+/- text bug)

2014-02-03 Thread Chris Angelico
On Tue, Feb 4, 2014 at 5:37 AM,  wxjmfa...@gmail.com wrote:
 Le lundi 3 février 2014 18:42:36 UTC+1, Rotwang a écrit :
 On 03/02/2014 13:59, wxjmfa...@gmail.com wrote:
 Hint: try clicking the ¶.

 I never was aware of this feature. Is it deliverate?

 It gives to me the feeling of a badly programmed
 html page, especially if this sign does correspond
 to an eol!

Very deliberate, and very useful. I don't know why that sign should
correspond to a line end; I grew up with it representing paragraph,
which is close to what it means here. (Well, that and Ctrl-T, since
it was character 20 on those old systems.) Yes, it does sometimes get
a little distracting as the mouse moves over and away, but it would be
more confusing to have it always shown, and I don't know of any better
way to do it.

ChrisA
-- 
https://mail.python.org/mailman/listinfo/python-list


Re: generator slides review and Python doc (+/- text bug)

2014-02-03 Thread Rotwang

On 03/02/2014 18:37, wxjmfa...@gmail.com wrote:

[...]

Hint: try clicking the ¶.


I never was aware of this feature. Is it deliverate?


Do you mean deliberate? Of course it is.



It gives to me the feeling of a badly programmed
html page, especially if this sign does correspond
to an eol!


Why on Earth would the sign correspond to an EOL? The section sign and 
pilcrow have a history of being used to refer to sections and paragraphs 
respectively, so using them for permalinks to individual sections of a 
web page makes perfect sense.


--
https://mail.python.org/mailman/listinfo/python-list


Re: generator slides review and Python doc (+/- text bug)

2014-02-03 Thread wxjmfauth
Le lundi 3 février 2014 19:55:26 UTC+1, Rotwang a écrit :
 On 03/02/2014 18:37, wxjmfa...@gmail.com wrote:
 
  [...]
 
 
 
  Hint: try clicking the ¶.
 
 
 
  I never was aware of this feature. Is it deliverate?
 
 
 
 Do you mean deliberate? Of course it is.
 
 
 
 
 
  It gives to me the feeling of a badly programmed
 
  html page, especially if this sign does correspond
 
  to an eol!
 
 
 
 Why on Earth would the sign correspond to an EOL? The section sign and 
 
 pilcrow have a history of being used to refer to sections and paragraphs 
 
 respectively, so using them for permalinks to individual sections of a 
 
 web page makes perfect sense.


Sorry. I should have written end of paragraph or section.

Having said this, that's because these signs are usually
used to signal an end of ...', that I find these signs
as link not really meaningful.


jmf

-- 
https://mail.python.org/mailman/listinfo/python-list


[OT] Usage of U+00B6 PILCROW SIGN (was: generator slides review and Python doc (+/- text bug))

2014-02-03 Thread Ben Finney
Rotwang sg...@hotmail.co.uk writes:

 Why on Earth would the [“¶”, U+00B6 PILCROW SIGN] correspond to an
 EOL? The section sign and pilcrow have a history of being used to
 refer to sections and paragraphs respectively, so using them for
 permalinks to individual sections of a web page makes perfect sense.

Symbols commonly have multiple meanings, derived from usage.

URL:https://en.wikipedia.org/wiki/Pilcrow#Contemporary_use

-- 
 \  “Progress might have been all right once, but it's gone on too |
  `\long.” —Ogden Nash |
_o__)  |
Ben Finney

-- 
https://mail.python.org/mailman/listinfo/python-list


Re: [OT] Usage of U+00B6 PILCROW SIGN (was: generator slides review and Python doc (+/- text bug))

2014-02-03 Thread wxjmfauth
Le lundi 3 février 2014 23:56:43 UTC+1, Ben Finney a écrit :
 Rotwang sg...@hotmail.co.uk writes:
 
 
 
  Why on Earth would the [¶, U+00B6 PILCROW SIGN] correspond to an
 
  EOL? The section sign and pilcrow have a history of being used to
 
  refer to sections and paragraphs respectively, so using them for
 
  permalinks to individual sections of a web page makes perfect sense.
 
 
 
 Symbols commonly have multiple meanings, derived from usage.
 
 
 
 URL:https://en.wikipedia.org/wiki/Pilcrow#Contemporary_use
 
 
 
 -- 
 
  \  Progress might have been all right once, but it's gone on too |
 
   `\long. --Ogden Nash |
 
 _o__)  |
 
 Ben Finney

I got it. If I'm visiting a page like this:

http://docs.python.org/3/tutorial/index.html#the-python-tutorial

1) To read the page, I'm scrolling down.
2) When I have finished to read the page, I scroll up
(or scroll back/up) to the top of the page until I see
this feature and the title.
3) I click on this feature.
4) The title, already visible, moves, let's say, 2cm higher.

...?


Having a pilcrow to signal or to display an end of paragraph is
one thing. Using a pilcrow as a link seems to me very strange.
Especially if the target of that link has nothing to with
paragraph, but with section!

jmf
-- 
https://mail.python.org/mailman/listinfo/python-list


Re: [OT] Usage of U+00B6 PILCROW SIGN (was: generator slides review and Python doc (+/- text bug))

2014-02-03 Thread Chris Angelico
On Tue, Feb 4, 2014 at 5:51 PM,  wxjmfa...@gmail.com wrote:
 2) When I have finished to read the page, I scroll up
 (or scroll back/up) to the top of the page until I see
 this feature and the title.
 3) I click on this feature.
 4) The title, already visible, moves, let's say, 2cm higher.

At which point your URL bar shows a hash link to this exact section,
which you can then copy and paste into an email, for instance. That's
what it's good for.

ChrisA
-- 
https://mail.python.org/mailman/listinfo/python-list