Show More
@@ -288,11 +288,11 b' Converting notebooks to other formats' | |||
|
288 | 288 | ------------------------------------- |
|
289 | 289 | Newly added in the 1.0 release of IPython is the ``nbconvert`` tool to convert a notebook document into another static format. This is a command line tool; at present, this functionality is not available to export directly from within the Notebook app. The syntax is:: |
|
290 | 290 | |
|
291 |
|
|
|
291 | $ ipython nbconvert notebook.ipynb | |
|
292 | 292 | |
|
293 | 293 | for standard HTML output, or:: |
|
294 | 294 | |
|
295 |
|
|
|
295 | $ ipython nbconvert --format=FORMAT notebook.ipynb | |
|
296 | 296 | |
|
297 | 297 | where ``FORMAT`` is the desired export format. Options for this format include: |
|
298 | 298 | |
@@ -331,9 +331,8 b' To create a new set of default configuration files, with lots of information on ' | |||
|
331 | 331 | :ref:`config_overview`, in particular :ref:`Profiles`. |
|
332 | 332 | |
|
333 | 333 | |
|
334 | ||
|
335 | Importing or executing a notebook as a normal Python file | |
|
336 | --------------------------------------------------------- | |
|
334 | Extracting standard Python files from notebooks | |
|
335 | ----------------------------------------------- | |
|
337 | 336 | |
|
338 | 337 | The native format of the notebook, a file with a ``.ipynb`` `extension, is a |
|
339 | 338 | JSON container of all the input and output of the notebook, and therefore not |
@@ -377,9 +376,9 b' and then on any cell that you need to protect, use::' | |||
|
377 | 376 | .. _notebook_security: |
|
378 | 377 | |
|
379 | 378 | Security |
|
380 | ======== | |
|
379 | -------- | |
|
381 | 380 | |
|
382 |
You can protect your |
|
|
381 | You can protect your Notebook server with a simple singlepassword by | |
|
383 | 382 | setting the :attr:`NotebookApp.password` configurable. You can prepare a |
|
384 | 383 | hashed password using the function :func:`IPython.lib.security.passwd`: |
|
385 | 384 | |
@@ -404,16 +403,13 b' You can then add this to your :file:`ipython_notebook_config.py`, e.g.::' | |||
|
404 | 403 | |
|
405 | 404 | When using a password, it is a good idea to also use SSL, so that your password |
|
406 | 405 | is not sent unencrypted by your browser. You can start the notebook to |
|
407 |
communicate via a secure protocol mode using a self-signed certificate |
|
|
408 | typing:: | |
|
406 | communicate via a secure protocol mode using a self-signed certificate with the command:: | |
|
409 | 407 | |
|
410 | 408 | $ ipython notebook --certfile=mycert.pem |
|
411 | 409 | |
|
412 | 410 | .. note:: |
|
413 | 411 | |
|
414 | A self-signed certificate can be generated with openssl. For example, the | |
|
415 | following command will create a certificate valid for 365 days with both | |
|
416 | the key and certificate data written to the same file:: | |
|
412 | A self-signed certificate can be generated with ``openssl``. For example, the following command will create a certificate valid for 365 days with both the key and certificate data written to the same file:: | |
|
417 | 413 | |
|
418 | 414 | $ openssl req -x509 -nodes -days 365 -newkey rsa:1024 -keyout mycert.pem -out mycert.pem |
|
419 | 415 | |
@@ -429,8 +425,6 b' notebook server over ``https://``, not over plain ``http://``. The startup' | |||
|
429 | 425 | message from the server prints this, but it's easy to overlook and think the |
|
430 | 426 | server is for some reason non-responsive. |
|
431 | 427 | |
|
432 | Quick how to's | |
|
433 | ============== | |
|
434 | 428 | |
|
435 | 429 | Connecting to an existing kernel |
|
436 | 430 | --------------------------------- |
@@ -525,36 +519,33 b' your Notebooks.' | |||
|
525 | 519 | |
|
526 | 520 | .. _notebook_format: |
|
527 | 521 | |
|
528 |
|
|
|
529 | =================== | |
|
522 | Notebook JSON format | |
|
523 | ==================== | |
|
530 | 524 | |
|
531 |
|
|
|
525 | Notebooks are JSON files with an ``.ipynb`` extension, formatted | |
|
532 | 526 | as legibly as possible with minimal extra indentation and cell content broken |
|
533 | 527 | across lines to make them reasonably friendly to use in version-control |
|
534 |
workflows. You should be very careful if you ever |
|
|
528 | workflows. You should be very careful if you ever manually edit this JSON | |
|
535 | 529 | data, as it is extremely easy to corrupt its internal structure and make the |
|
536 | 530 | file impossible to load. In general, you should consider the notebook as a |
|
537 | file meant only to be edited by IPython itself, not for hand-editing. | |
|
531 | file meant only to be edited by the IPython Notebook app itself, not for hand-editing. | |
|
538 | 532 | |
|
539 | 533 | .. note:: |
|
540 | 534 | |
|
541 | 535 | Binary data such as figures are directly saved in the JSON file. This |
|
542 |
provides convenient single-file portability but means the files can |
|
|
543 |
|
|
|
544 |
blobs are encoded in a single line the |
|
|
545 | output, but they are typically very long lines. You can use the | |
|
546 | 'ClearAll' button to remove all output from a notebook prior to | |
|
547 | committing it to version control, if this is a concern. | |
|
548 | ||
|
549 | The notebook server can also generate a pure-python version of your notebook, | |
|
550 | by clicking on the 'Download' button and selecting ``py`` as the format. This | |
|
551 | file will contain all the code cells from your notebook verbatim, and all text | |
|
552 | cells prepended with a comment marker. The separation between code and text | |
|
536 | provides convenient single-file portability, but means that the files can | |
|
537 | be large; ``diff``s of binary data also are not very meaningful. Since the | |
|
538 | binary blobs are encoded in a single line, they affect only one line of | |
|
539 | the ``diff`` output, but they are typically very long lines. You can use the ``Cell -> All Output -> Clear`` menu option to remove all output from a notebook prior to committing it to version control, if this is a concern. | |
|
540 | ||
|
541 | The notebook server can also generate a pure Python version of your notebook, | |
|
542 | using the ``File -> Download as`` menu option. The resulting ``.py`` file will | |
|
543 | contain all the code cells from your notebook verbatim, and all text cells | |
|
544 | prepended with a comment marker. The separation between code and text | |
|
553 | 545 | cells is indicated with special comments and there is a header indicating the |
|
554 |
format version. All output is stripped out when exporting to |
|
|
546 | format version. All output is stripped out when exporting to Python. | |
|
555 | 547 | |
|
556 | Here is an example of a simple notebook with one text cell and one code input | |
|
557 | cell, when exported to python format:: | |
|
548 | Here is an example of the Python output from a simple notebook with one text cell and one code input cell:: | |
|
558 | 549 | |
|
559 | 550 | # <nbformat>2</nbformat> |
|
560 | 551 | |
@@ -564,14 +555,14 b' cell, when exported to python format::' | |||
|
564 | 555 | |
|
565 | 556 | # <codecell> |
|
566 | 557 | |
|
567 |
print " |
|
|
558 | print "Hello, IPython!" | |
|
568 | 559 | |
|
569 | 560 | |
|
570 | 561 | Known issues |
|
571 | 562 | ============ |
|
572 | 563 | |
|
573 | 564 | When behind a proxy, especially if your system or browser is set to autodetect |
|
574 |
the proxy, the |
|
|
565 | the proxy, the Notebook app might fail to connect to the server's websockets, | |
|
575 | 566 | and present you with a warning at startup. In this case, you need to configure |
|
576 | 567 | your system not to use the proxy for the server's address. |
|
577 | 568 |
General Comments 0
You need to be logged in to leave comments.
Login now