DOC: easier copy-and-paste of code examples

[tv3141]

Code blocks in the user guide and reference guide cannot be copied and pasted as a whole as they contain >>> and ...:

>>> for foo in bar:
...     print(foo)

One approach would be a toggle like numpy uses in their manual.

• PR for http->https in doc template
• PR for http->https in released docs

[pelson]

We actually used to have this. Looks like it stopped working.

Looks like the move over to https stopped this working (diagnosed by enabling insecure scripts in the docs).

The line is at https://github.com/SciTools/iris/blob/master/docs/iris/src/_templates/layout.html#L9. It would take a PR to scitools/iris and a PR to http://github.com/scitools/scitools.org.uk to search and replace http://docs.python.org/2/_static/copybutton.js with https://docs.python.org/2/_static/copybutton.js. Interested in doing it @tv3141 ?

[tv3141]

@pelson Yes, I can have a look at this.

[pelson]

Thanks for doing this!

[tv3141]

Copybutton is broken in Iris2.2, example

I think I broke this in #3071.

Iris2.2 code blocks:

<div class="highlight-default notranslate">
<div class="highlight">
<pre>
<span></span>
...

Iris2.1 code blocks:

<div class="highlight-python notranslate" style="position: relative;">
<div class="highlight">
<span class="copybutton" title="Hide the prompts and output" style="cursor: pointer; position: absolute; top: 0px; right: 0px; border-color: rgb(204, 204, 204); border-style: solid; border-width: 0.994318px; color: rgb(204, 204, 204); font-family: monospace; padding-left: 0.2em; padding-right: 0.2em;">&gt;&gt;&gt;</span>
<pre>
...

@pelson Do you want to reopen this ticket or open a new one?

[pelson]

I've reopened. Are you interested in taking a look at this @tv3141?