NBConvert chưa được thay thế đầy đủ bởi NBConvert2, bạn vẫn có thể sử dụng nó nếu bạn muốn, nếu không chúng tôi đã loại bỏ thực thi. Đó chỉ là một cảnh báo rằng chúng tôi không còn lỗi NBConvert1 nữa.
Điều sau đây sẽ hoạt động:
./nbconvert.py --format=pdf yourfile.ipynb
Nếu bạn đang sử dụng phiên bản đủ gần đây của IPython, không sử dụng chế độ xem in, chỉ cần sử dụng hộp thoại in bình thường. Biểu đồ cắt giảm chrome là một vấn đề đã biết [Chrome không tôn trọng một số CSS in] và hoạt động tốt hơn nhiều với Firefox, không phải tất cả các phiên bản vẫn còn.
Đối với NBConvert2, nó vẫn rất cao và tài liệu cần được viết.
NBViewer sử dụng NBConvert2 để nó khá tốt với HTML.
Danh sách các hồ sơ có sẵn hiện tại:
$ ls -l1 profile|cut -d. -f1
base_html
blogger_html
full_html
latex_base
latex_sphinx_base
latex_sphinx_howto
latex_sphinx_manual
markdown
python
reveal
rst
Cung cấp cho bạn các hồ sơ hiện có. [Bạn có thể tạo tài liệu tương lai của riêng bạn,
$ ls -l1 profile|cut -d. -f1
base_html
blogger_html
full_html
latex_base
latex_sphinx_base
latex_sphinx_howto
latex_sphinx_manual
markdown
python
reveal
rst
7 sẽ cung cấp cho bạn một số tùy chọn bạn có thể sử dụng trong hồ sơ của mình.]sau đó
$ ./nbconvert2.py [profilename] --no-stdout --write=True
Và nó nên viết các tệp [TEX] của bạn miễn là các số liệu được trích xuất trong CWD. Vâng, tôi biết điều này không rõ ràng, và nó có thể sẽ thay đổi do đó không có tài liệu ...
Lý do cho điều đó là NBConvert2 sẽ chủ yếu là thư viện Python trong đó trong mã giả bạn có thể làm:library where in pseudo code you can do :
MyConverter = NBConverter[config=config]
ipynb = read[ipynb_file]
converted_files = MyConverter.convert[ipynb]
for file in converted_files :
write[file]
Điểm vào sẽ đến sau, một khi API được ổn định.
Tôi sẽ chỉ ra rằng @jdfreder [hồ sơ GitHub] đang hoạt động trên xuất TEX/PDF/Sphinx và là chuyên gia tạo PDF từ tệp IPYNB tại thời điểm viết bài này.
Điều này sẽ mở sổ ghi chép, thực hiện nó, nắm bắt đầu ra mới và lưu kết quả trong
jupyter nbconvert your_talk.ipynb --to slides --reveal-prefix reveal.js7. Chỉ định
jupyter nbconvert your_talk.ipynb --to slides --reveal-prefix reveal.js8 sẽ ghi đè lên tệp đầu vào thay vì viết một tệp mới. Theo mặc định,
$ ls -l1 profile|cut -d. -f1
base_html
blogger_html
full_html
latex_base
latex_sphinx_base
latex_sphinx_howto
latex_sphinx_manual
markdown
python
reveal
rst
8 sẽ hủy bỏ chuyển đổi nếu có bất kỳ ngoại lệ nào xảy ra trong quá trình thực hiện một ô. Nếu bạn chỉ định jupyter nbconvert your_talk.ipynb --to slides --reveal-prefix reveal.js --post serve0 [ngoài cờ
jupyter nbconvert your_talk.ipynb --to slides --reveal-prefix reveal.js --post serve1] thì việc chuyển đổi sẽ tiếp tục và đầu ra từ bất kỳ ngoại lệ nào sẽ được bao gồm trong đầu ra ô.
$ jupyter nbconvert --to FORMAT notebook.ipynb
Lệnh sau:
sẽ tạo một bản sao của jupyter nbconvert your_talk.ipynb --to slides --reveal-prefix reveal.js --post serve
2 trong jupyter nbconvert your_talk.ipynb --to slides --reveal-prefix reveal.js --post serve
3 trong phiên bản 3 của định dạng Notebook.
Nếu bạn muốn chuyển đổi một máy tính xách tay tại chỗ, bạn có thể chỉ định tệp đầu ra giống như tệp đầu vào:
Hãy cẩn thận với điều đó, vì nó sẽ thay thế tệp đầu vào.
NBConvert sử dụng pandoc để chuyển đổi giữa các ngôn ngữ đánh dấu khác nhau, vì vậy pandoc là một sự phụ thuộc khi chuyển đổi sang latex hoặc tái cấu trúc.
HTML,,
LaTeX,,
PDF,,
WebPDF,,
Tệp đầu ra được tạo bởi
8 sẽ có cùng tên cơ sở với sổ ghi chép và sẽ được đặt trong thư mục làm việc hiện tại. Bất kỳ tệp hỗ trợ nào [đồ họa, v.v.] sẽ được đặt trong một thư mục mới có cùng tên cơ sở với máy tính xách tay, được hậu tố với$ ls -l1 profile|cut -d. -f1 base_html blogger_html full_html latex_base latex_sphinx_base latex_sphinx_howto latex_sphinx_manual markdown python reveal rst
jupyter nbconvert your_talk.ipynb --to slides --reveal-prefix reveal.js --post serve5:,Markdown,,
Ascii,,
reStructuredText,,
Đối với đầu ra một tệp đơn giản, chẳng hạn như HTML, Markdown, v.v., đầu ra có thể được gửi đến đầu ra tiêu chuẩn với:,
notebook..
Chuyển đổi nhiều máy tính xách tay
Nhiều máy tính xách tay có thể được chỉ định từ dòng lệnh:
5$ ./nbconvert2.py [profilename] --no-stdout --write=True
hoặc thông qua danh sách trong tệp cấu hình, giả sử
jupyter nbconvert your_talk.ipynb --to slides --reveal-prefix reveal.js --post serve
6, chứa văn bản:và sử dụng lệnh:
Cú pháp dòng lệnh để chạy tập lệnh
8 là:$ ls -l1 profile|cut -d. -f1 base_html blogger_html full_html latex_base latex_sphinx_base latex_sphinx_howto latex_sphinx_manual markdown python reveal rst
Điều này sẽ chuyển đổi tệp Notebook Jupyter
9 thành định dạng đầu ra được đưa ra bởi chuỗi$ ls -l1 profile|cut -d. -f1 base_html blogger_html full_html latex_base latex_sphinx_base latex_sphinx_howto latex_sphinx_manual markdown python reveal rst
0.$ ./nbconvert2.py [profilename] --no-stdout --write=True
Định dạng đầu ra mặc định
5MyConverter = NBConverter[config=config] ipynb = read[ipynb_file] converted_files = MyConverter.convert[ipynb] for file in converted_files : write[file]
Trong các phiên bản 5.x của NBConvert, định dạng đầu ra mặc định là HTML. Trong 6.0, mặc định đã bị xóa, yêu cầu các cuộc gọi CLI phải đặt một đối số
1 một cách rõ ràng để thực thi. Để bắt chước hành vi gốc 5.x, người ta nên thêm$ ./nbconvert2.py [profilename] --no-stdout --write=True
2 vào lệnh$ ./nbconvert2.py [profilename] --no-stdout --write=True
3.$ ./nbconvert2.py [profilename] --no-stdout --write=True
6MyConverter = NBConverter[config=config] ipynb = read[ipynb_file] converted_files = MyConverter.convert[ipynb] for file in converted_files : write[file]
Các định dạng đầu ra được hỗ trợ Jo
7MyConverter = NBConverter[config=config] ipynb = read[ipynb_file] converted_files = MyConverter.convert[ipynb] for file in converted_files : write[file]
Các định dạng đầu ra hiện được hỗ trợ là:
Tiết lộ.js HTML Slideshow,
8MyConverter = NBConverter[config=config] ipynb = read[ipynb_file] converted_files = MyConverter.convert[ipynb] for file in converted_files : write[file]
tập lệnh thực thi,
Jupyter cũng cung cấp một vài mẫu cho các định dạng đầu ra. Chúng có thể được chỉ định thông qua một đối số
4 bổ sung và được liệt kê trong các phần dưới đây.$ ./nbconvert2.py [profilename] --no-stdout --write=True
Html¶
$ jupyter nbconvert --to FORMAT notebook.ipynb
1Báo cáo latex, cung cấp một bảng nội dung và chương.
Ghi chú
NBConvert sử dụng pandoc để chuyển đổi giữa các ngôn ngữ đánh dấu khác nhau, vì vậy pandoc là một sự phụ thuộc khi chuyển đổi sang latex hoặc tái cấu trúc.
Pdf¶
$ jupyter nbconvert --to FORMAT notebook.ipynb
2Tạo PDF thông qua latex. Hỗ trợ các mẫu giống như
8.MyConverter = NBConverter[config=config] ipynb = read[ipynb_file] converted_files = MyConverter.convert[ipynb] for file in converted_files : write[file]
Webpdf¶
$ jupyter nbconvert --to FORMAT notebook.ipynb
4Tạo PDF bằng cách kết xuất đầu tiên thành HTML, hiển thị không có crom HTML và xuất sang PDF. Nhà xuất khẩu này hỗ trợ các mẫu giống như
5.$ ./nbconvert2.py [profilename] --no-stdout --write=True
Nhà xuất khẩu WebPDF yêu cầu thư viện tự động hóa
$ jupyter nbconvert --to FORMAT notebook.ipynb
6, có thể được cài đặt thông qua$ jupyter nbconvert --to FORMAT notebook.ipynb
7.
Tiết lộ.js HTML Slideshow¶
Ghi chú
NBConvert sử dụng pandoc để chuyển đổi giữa các ngôn ngữ đánh dấu khác nhau, vì vậy pandoc là một sự phụ thuộc khi chuyển đổi sang latex hoặc tái cấu trúc.
$ jupyter nbconvert --to FORMAT notebook.ipynb
8Pdf¶
Tạo PDF thông qua latex. Hỗ trợ các mẫu giống như
MyConverter = NBConverter[config=config]
ipynb = read[ipynb_file]
converted_files = MyConverter.convert[ipynb]
for file in converted_files :
write[file]
8.Webpdf¶
Tạo PDF bằng cách kết xuất đầu tiên thành HTML, hiển thị không có crom HTML và xuất sang PDF. Nhà xuất khẩu này hỗ trợ các mẫu giống như
$ ./nbconvert2.py [profilename] --no-stdout --write=True
5.Nhà xuất khẩu WebPDF yêu cầu thư viện tự động hóa
$ jupyter nbconvert --to FORMAT notebook.ipynb6, có thể được cài đặt thông qua
$ jupyter nbconvert --to FORMAT notebook.ipynb7.
Tiết lộ.js HTML Slideshow¶
Để chỉ định một ánh xạ từ các ô sổ ghi chép để tiết lộ.js slide, từ bên trong sổ ghi chép Jupyter, chọn View item Menu -> Thanh công cụ ô -> Slideshow. Điều đó sẽ tiết lộ một menu thả xuống ở phía trên bên phải của mỗi ô. Từ đó, người ta có thể chọn từ slide, slide slide, slide slide, trò chơi, cách thức, các nốt nhạc, và các ghi chú. Khi chuyển đổi, các ô được chỉ định là Skip Skip sẽ không được bao gồm, các ghi chú của Google sẽ chỉ được đưa vào ghi chú của người trình bày, v.v.
Điều này tạo ra một trình chiếu HTML HTML tiết lộ.
Chạy trình chiếu này yêu cầu một bản sao của tiết lộ.js [phiên bản 4.x].
Theo mặc định, điều này sẽ bao gồm một thẻ tập lệnh trong HTML sẽ trực tiếp tải tiết lộ.js từ CDN công khai.
git clone //github.com/hakimel/reveal.js.git cd reveal.js git checkout 3.5.0 cd ..
Điều này có nghĩa là nếu bạn bao gồm các slide của bạn trên một trang web, chúng nên hoạt động như mong đợi. Tuy nhiên, một số tính năng [cụ thể là loa ghi chú & bộ hẹn giờ] sẽ không hoạt động trên trang web vì chúng yêu cầu truy cập vào một bản sao địa phương của tiết lộ.js.
jupyter nbconvert your_talk.ipynb --to slides --reveal-prefix reveal.js
Ghi chú loa yêu cầu một bản sao cục bộ của tiết lộ.js. Sau đó, bạn cần nói
$ ls -l1 profile|cut -d. -f1
base_html
blogger_html
full_html
latex_base
latex_sphinx_base
latex_sphinx_howto
latex_sphinx_manual
markdown
python
reveal
rst
8 làm thế nào để tìm bản sao địa phương đó.Bộ định thời chỉ hoạt động nếu bạn đã có ghi chú loa, nhưng cũng yêu cầu một máy chủ HTTPS cục bộ. Bạn có thể đọc thêm về điều này trong phục vụPostProcessorExample.
Để làm cho điều này rõ ràng hơn, hãy để Lôi xem xét một ví dụ về cách lấy ghi chú của người nói làm việc với một bản sao cục bộ của tiết lộ.js: slideswithnotesexample.
Ví dụ: Tạo các slide w/ loa ghi chú
Hãy giả sử bạn có một cuốn sổ tay
git clone //github.com/hakimel/reveal.js.git cd reveal.js git checkout 3.5.0 cd ..0 mà bạn muốn chuyển đổi sang các slide. Trong ví dụ này, chúng tôi sẽ giả sử rằng bạn đang làm việc trong cùng thư mục với máy tính xách tay bạn muốn chuyển đổi [tức là, khi bạn chạy
git clone //github.com/hakimel/reveal.js.git cd reveal.js git checkout 3.5.0 cd ..1,
git clone //github.com/hakimel/reveal.js.git cd reveal.js git checkout 3.5.0 cd ..0 hiển thị giữa danh sách các tệp].
jupyter nbconvert your_talk.ipynb --to slides --reveal-prefix reveal.js --post serve
Đầu tiên, chúng tôi cần một bản sao của tiết lộ.js trong cùng thư mục với các slide của bạn. Một cách để làm điều này là sử dụng các lệnh sau trong thiết bị đầu cuối của bạn:
Sau đó, chúng ta cần nói với NBConvert để trỏ đến bản sao cục bộ này. Để làm điều đó, chúng tôi sử dụng cờ dòng lệnh git clone //github.com/hakimel/reveal.js.git
cd reveal.js
git checkout 3.5.0
cd ..
3 để trỏ đến bản sao cục bộ.
jupyter nbconvert your_talk.ipynb --to slides --reveal-prefix reveal.js
2Điều này sẽ tạo tệp
git clone //github.com/hakimel/reveal.js.git cd reveal.js git checkout 3.5.0 cd ..
4, mà bạn sẽ có thể truy cập vớigit clone //github.com/hakimel/reveal.js.git cd reveal.js git checkout 3.5.0 cd ..
5. Để truy cập các ghi chú của loa, nhấngit clone //github.com/hakimel/reveal.js.git cd reveal.js git checkout 3.5.0 cd ..
6 sau khi tải slide và chúng nên mở trong một cửa sổ mới.
Lưu ý: Điều này không cho phép các slide chạy hoàn toàn ngoại tuyến. Mặc dù bạn có một bản sao cục bộ của tiết lộ, theo mặc định, các slide cần truy cập MathJax, yêu cầu và jQuery thông qua CDN công khai. Giải quyết trường hợp sử dụng này là một vấn đề mở và PR luôn được khuyến khích.
jupyter nbconvert your_talk.ipynb --to slides --reveal-prefix reveal.js
3Phục vụ slide với máy chủ ________ 57¶
Khi bạn có ghi chú loa hoạt động, bạn có thể nhận thấy rằng bộ hẹn giờ của bạn không hoạt động. Đồng hồ bấm giờ đòi hỏi thêm một chút cơ sở hạ tầng; Bạn cần phục vụ bản sao địa phương của Confirm.js từ một máy chủ HTTPS cục bộ.
jupyter nbconvert your_talk.ipynb --to slides --reveal-prefix reveal.js
4May mắn thay,
8 làm cho điều này khá đơn giản thông qua việc sử dụng$ ls -l1 profile|cut -d. -f1 base_html blogger_html full_html latex_base latex_sphinx_base latex_sphinx_howto latex_sphinx_manual markdown python reveal rst
git clone //github.com/hakimel/reveal.js.git cd reveal.js git checkout 3.5.0 cd ..
9. Để kích hoạt máy chủ này, chúng tôi nối cờ dòng lệnhgit clone //github.com/hakimel/reveal.js.git cd reveal.js git checkout 3.5.0 cd ..
7 vào cuộc gọi của chúng tôi đến NBConvert.Ghi chú
Điều này sẽ chạy máy chủ, sẽ chiếm thiết bị đầu cuối mà bạn đã chạy lệnh cho đến khi bạn dừng nó. Bạn có thể dừng máy chủ bằng cách nhấn
jupyter nbconvert your_talk.ipynb --to slides --reveal-prefix reveal.js
1 hai lần.
Đánh dấu
jupyter nbconvert your_talk.ipynb --to slides --reveal-prefix reveal.js
5Đầu ra đánh dấu đơn giản. Các tế bào đánh dấu không bị ảnh hưởng và các ô mã thụt vào 4 không gian. Hình ảnh là đầu ra dưới dạng tệp .png trong một thư mục.
Ascii¶
jupyter nbconvert --to script my_julia_notebook.ipynb
Đầu ra ASCII. Hình ảnh là đầu ra dưới dạng tệp .png trong một thư mục.
jupyter nbconvert your_talk.ipynb --to slides --reveal-prefix reveal.js
6Tái cấu trúcText¶
Điều này không chuyển đổi một cuốn sổ tay sang một định dạng khác, thay vào đó, nó cho phép chạy các tiền xử lý của NBConvert trên một cuốn sổ tay và/hoặc chuyển đổi sang các định dạng máy tính xách tay khác. Ví dụ:
jupyter nbconvert --to notebook --execute mynotebook.ipynb
Điều này sẽ mở sổ ghi chép, thực hiện nó, nắm bắt đầu ra mới và lưu kết quả trong
jupyter nbconvert your_talk.ipynb --to slides --reveal-prefix reveal.js7. Chỉ định
jupyter nbconvert your_talk.ipynb --to slides --reveal-prefix reveal.js8 sẽ ghi đè lên tệp đầu vào thay vì viết một tệp mới. Theo mặc định,
$ ls -l1 profile|cut -d. -f1
base_html
blogger_html
full_html
latex_base
latex_sphinx_base
latex_sphinx_howto
latex_sphinx_manual
markdown
python
reveal
rst
8 sẽ hủy bỏ chuyển đổi nếu có bất kỳ ngoại lệ nào xảy ra trong quá trình thực hiện một ô. Nếu bạn chỉ định jupyter nbconvert your_talk.ipynb --to slides --reveal-prefix reveal.js --post serve0 [ngoài cờ
jupyter nbconvert your_talk.ipynb --to slides --reveal-prefix reveal.js --post serve1] thì việc chuyển đổi sẽ tiếp tục và đầu ra từ bất kỳ ngoại lệ nào sẽ được bao gồm trong đầu ra ô.
Lệnh sau:
$ ls -l1 profile|cut -d. -f1
base_html
blogger_html
full_html
latex_base
latex_sphinx_base
latex_sphinx_howto
latex_sphinx_manual
markdown
python
reveal
rst
0sẽ tạo một bản sao của
jupyter nbconvert your_talk.ipynb --to slides --reveal-prefix reveal.js --post serve2 trong
jupyter nbconvert your_talk.ipynb --to slides --reveal-prefix reveal.js --post serve3 trong phiên bản 3 của định dạng Notebook.
Nếu bạn muốn chuyển đổi một máy tính xách tay tại chỗ, bạn có thể chỉ định tệp đầu ra giống như tệp đầu vào:
$ ls -l1 profile|cut -d. -f1
base_html
blogger_html
full_html
latex_base
latex_sphinx_base
latex_sphinx_howto
latex_sphinx_manual
markdown
python
reveal
rst
1Hãy cẩn thận với điều đó, vì nó sẽ thay thế tệp đầu vào.
Ghi chú
NBConvert sử dụng pandoc để chuyển đổi giữa các ngôn ngữ đánh dấu khác nhau, vì vậy pandoc là một sự phụ thuộc khi chuyển đổi sang latex hoặc tái cấu trúc.
Tệp đầu ra được tạo bởi
$ ls -l1 profile|cut -d. -f1
base_html
blogger_html
full_html
latex_base
latex_sphinx_base
latex_sphinx_howto
latex_sphinx_manual
markdown
python
reveal
rst
8 sẽ có cùng tên cơ sở với sổ ghi chép và sẽ được đặt trong thư mục làm việc hiện tại. Bất kỳ tệp hỗ trợ nào [đồ họa, v.v.] sẽ được đặt trong một thư mục mới có cùng tên cơ sở với máy tính xách tay, được hậu tố với jupyter nbconvert your_talk.ipynb --to slides --reveal-prefix reveal.js --post serve5:
$ ls -l1 profile|cut -d. -f1
base_html
blogger_html
full_html
latex_base
latex_sphinx_base
latex_sphinx_howto
latex_sphinx_manual
markdown
python
reveal
rst
2Đối với đầu ra một tệp đơn giản, chẳng hạn như HTML, Markdown, v.v., đầu ra có thể được gửi đến đầu ra tiêu chuẩn với:
$ ls -l1 profile|cut -d. -f1
base_html
blogger_html
full_html
latex_base
latex_sphinx_base
latex_sphinx_howto
latex_sphinx_manual
markdown
python
reveal
rst
3Chuyển đổi nhiều máy tính xách tay
Nhiều máy tính xách tay có thể được chỉ định từ dòng lệnh:
$ ls -l1 profile|cut -d. -f1
base_html
blogger_html
full_html
latex_base
latex_sphinx_base
latex_sphinx_howto
latex_sphinx_manual
markdown
python
reveal
rst
4hoặc thông qua danh sách trong tệp cấu hình, giả sử
jupyter nbconvert your_talk.ipynb --to slides --reveal-prefix reveal.js --post serve6, chứa văn bản:
$ ls -l1 profile|cut -d. -f1
base_html
blogger_html
full_html
latex_base
latex_sphinx_base
latex_sphinx_howto
latex_sphinx_manual
markdown
python
reveal
rst
5và sử dụng lệnh:
$ ls -l1 profile|cut -d. -f1
base_html
blogger_html
full_html
latex_base
latex_sphinx_base
latex_sphinx_howto
latex_sphinx_manual
markdown
python
reveal
rst
6