{ "cells": [ { "cell_type": "markdown", "metadata": { "hide_input": true }, "source": [ "## Conversion notebook to HTML" ] }, { "cell_type": "markdown", "metadata": { "hide_input": true }, "source": [ "This is the module to convert a jupyter notebook to an html page. It will normally render everything the way it was in the notebooks, including suppressing the input of the code cells with input cells masked, and converting the links between notebooks in links between the html pages." ] }, { "cell_type": "code", "execution_count": 1, "metadata": { "hide_input": true }, "outputs": [], "source": [ "from fastai.gen_doc.nbdoc import * \n", "from fastai.gen_doc.convert2html import * " ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Functions" ] }, { "cell_type": "code", "execution_count": 2, "metadata": { "hide_input": true }, "outputs": [ { "data": { "text/markdown": [ "

convert_nb[source][test]

\n", "\n", "> convert_nb(**`fname`**, **`dest_path`**=***`'.'`***)\n", "\n", "
×

No tests found for convert_nb. To contribute a test please refer to this guide and this discussion.

\n", "\n", "Convert a notebook `fname` to html file in `dest_path`. " ], "text/plain": [ "" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "show_doc(convert_nb)" ] }, { "cell_type": "code", "execution_count": 3, "metadata": { "hide_input": true }, "outputs": [ { "data": { "text/markdown": [ "

convert_all[source][test]

\n", "\n", "> convert_all(**`folder`**, **`dest_path`**=***`'.'`***, **`force_all`**=***`False`***)\n", "\n", "
×

No tests found for convert_all. To contribute a test please refer to this guide and this discussion.

\n", "\n", "Convert modified notebooks in `folder` to html pages in `dest_path`. " ], "text/plain": [ "" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "show_doc(convert_all)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Here's an example to convert all the docs in this folder:\n", "\n", "``` python\n", "convert_all('.', '../docs')\n", "```" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Undocumented Methods - Methods moved below this line will intentionally be hidden" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## New Methods - Please document or move to the undocumented section" ] }, { "cell_type": "code", "execution_count": 4, "metadata": { "hide_input": true }, "outputs": [ { "data": { "text/markdown": [ "

read_nb[source][test]

\n", "\n", "> read_nb(**`fname`**)\n", "\n", "
×

No tests found for read_nb. To contribute a test please refer to this guide and this discussion.

\n", "\n", "Read the notebook in `fname`. " ], "text/plain": [ "" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "show_doc(read_nb)" ] } ], "metadata": { "jekyll": { "keywords": "fastai", "summary": "Converting the documentation notebooks to HTML pages", "title": "gen_doc.convert2html" }, "kernelspec": { "display_name": "Python 3", "language": "python", "name": "python3" }, "language_info": { "codemirror_mode": { "name": "ipython", "version": 3 }, "file_extension": ".py", "mimetype": "text/x-python", "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython3", "version": "3.8.2" } }, "nbformat": 4, "nbformat_minor": 2 }