ノート/jupyterとmarkdown

サイトトップ

ノート
データ処理
├マイニング
├バスケット解析
├バスケット解析をＲで
├図書貸出をＲで
├モデルクラスタリング
└
テキストマイニング
├テキストマイニングTM
├TMとシソーラス
├PubMedをTM
├TMとMeSH
├TMとNLTK
├テキストマイニングとtagger
├医薬品添付文書ＤＢ
├論文の処理1
├剽窃１
├Bing検索
└
分子進化学
├分子進化学
└
Pythonと論文アクセス
├Pythonを使ってみる
├PythonでPubMed
├Pythonで...続き
└
Macメモ
├Script

&ref(): File not found: "favicon_story.txt" at page "ノート/ノート";

自信ないので
├Winのバッチ
│├スクリプト入門
│├バッチファイル
│├SETコマンド
│├自分のメモ
│└
└

メニュー編集

2017/04/15　jupyter notebook と markdown でスライドを作るときのメモ †

↑

オーバービュー †

                           +-> 専用環境内で表示
　+----------------+       |
　| 文書本文を     | -表示-+-> 専用ソフトで変換
　| markdownで記述 |       |
　+----------------+       +-> ホームページとして表示
　専用環境の場合もあるし         表示javascriptを読み込む
　テキストエディタのこと
　もある

markdownとは

文書やスライドの「整形」を、MSWordやPowerPointではGUIによって場所と形を選択するが、
markdownでは原稿の文と一緒にコマンドを（文字で）書込み、それを整形して表示する。
同じ考えのものは、様々なWiki、文書整形システム（TeXなど）、ホームページ（のタグ）などがある。

利点は

記述が比較的簡単、特にTeXなどの大規模文書成型システムに比べると単純。
その代わり、できないこともいっぱいある。
文字だけなので、マウスなどをいじる必要がない。どんどん書ける。欠点は
表現にはかなり制約が多い

理解しなければならないのは、

markdownの書き方（文法）　～　（かなり）標準化されている
専用環境を用いて入力（エディット）するなら、その環境の操作法
整形して表示するソフトやシステムの操作法

↑

markdownの書き方（備忘録） †

Markdown記法一覧　や　Markdown記法チートシート　を参照。
Markdownの原文については、Daring Fireball: Markdown Syntax Documentationを参照。

見出し（h1など）	# （後にスペースを置くこと）<br> ## (h2)、### (h3)
アイテムリスト	-か+か* （後にスペースを置く）
番号リスト	数字. （数字は何でもいいらしい）
改行	行末にスペース２つ
行内コード表示	`hoge`
コードブロック	行頭にスペース３つか、タブ、また```で囲むというのもあり

↑

専用環境atomでの扱い †

markdown編集・整形出力用のいろいろなソフト（アプリ）がある。たとえばGitHub上に上げるためのkobitoとか。

ここではatomを使ってみる。atomは、markdownの入力と、（同時）整形表示ができる。

元々は、atomは汎用で、プラグインによって機能を追加する形で実現している。

↑

jupyter notebook環境で †

jupyter notebook 環境では、markdownのセルが書ける。

markdownセルにするには、セルを選択した状態で、上部CellタブからCell Typeを選択し、markdownを選択する。markdownのセルは、Ctrl-Enterで整形表示される。

Cell TypeでCodeを指定するとコードを書くセルになり、markdown表示できない。

スライドにしたい場合は、更にそれぞれのセルの右肩のSlide TypeをSlideやSubSlideに指定。これが空欄のままだと、スライド表示の時にそのセルが含まれなくなる。

画像ファイルは、今編集しているmarkdownのファイル（ipynbファイル）と同じディレクトリに置く。

↑

Jupyter NotebookでRISE extensionを使って（大きく）表示する(2018-04-28追加) †

インストールはコマンドレベルで

pip install RISE
jupyter-nbextension install rise --py --sys-prefix
jupyter-nbextension enable rise --py --sys-prefix

CellごとにPython3やMarkdownのプロパティをつけるが、いずれにしてもRunして、表示形式にしておく。

view->Cell Toolbar->slideshowを選択しスライドショー用の設定画面にしておく。それぞれのCellの右側Slide Typeでスライド(単独もしくは開始）Slideや追加部分Fragmentを選ぶ。

セルを選択して、上欄メニューのグラフマークをクリックするとスライドショー開始。

参考：

[[Jupyter Notebookでプレゼンをするとっても便利な方法：https://qiita.com/cvusk/items/d425751ba663dc8c6517]]
【Day-5】Jupyterでできる！イケてるプレゼンスライドの作り方

↑

公開用にホームページ化（html化）する †

完成したら、FileタブでSave and Checkpointでセーブしておき、コマンドプロンプト画面からコマンド nbconvert を使ってhtmlに変換することができる。コマンドは

nbconvert --to slides <ipynbファイル名>

変換されたhtmlファイルは画像等は含まないので、常に同じディレクトリ上に画像ファイルをすべて持たせておくこと。つまり、Webサーバーの表示用ディレクトリへコピーする場合に、画像ファイルも一緒にコピーすること。また、reveal.jsディレクトリ以下のファイルもコピーすること。

SE-Linux環境では、コピーしたHTMLファイルや画像ファイルが、Webサーバープログラム（httpd）からアクセスできない（アクセス権限が足りない）ケースがある。そのファイルを閲覧しようとすると、404 Forbiddenが出たりする。そのファイルの属性を見るために、lsコマンドで-Zオプションを付けてみると、

$ ls -lZ mytest.html
-rw-rw-r--. yamanouc yamanouc unconfined_u:object_r:user_home_t:s0 mytest.html

と出たりするが、下の場合に比べて分かる通り、Webサーバーのアクセス権限がない。

ls -lZ AE-mytest.html
-rw-rw-r--. yamanouc yamanouc unconfined_u:object_r:httpd_user_content_t:s0 mytest.html

のように、httpd_user_content_t の属性が付いていなければならない。上位のディレクトリノードがhttpdの属性を持っていれば、その下に作ったファイルは継承するのだが、他からコピーして持ってきた場合には継承しないらしい。

ファイルに、属性を個別にいろいろと設定をするとできるようだが、簡単な方法として、

$ restorecon ファイル名

とするとよい。（たいていうまく行く）この辺はいろいろなところに書いてあるが、たとえば　[[ 新SELinux入門第5回　タイプを変更してトラブルに対処する:http://dpsnet.ddo.jp/MEMO/itpro013.htm]]　など参照。

↑

PDF化 †

スライドをPDFファイルに変換するには、まずブラウザで表示しておいて、

http:// ... hostname ... / ... directory ... /presentation.slides.html/

その次に、URLに「?print-pdf」を追加する

http:// ... hostname ... / ... directory ... /presentation.slides.html?print-pdf

これで開いた状態（js上ではpdf-printが読み込まれている）で、ブラウザの印刷（ctl-Pもしくは右クリックで「印刷」）。
これによって全ページがPDF化され、「保存」の指定でファイルに保存できる。

大きさが１ページに収まらない（縦に長い）ページは、２ページに印刷されるので、注意。結局はソースを短くなるように修正するしかなさそうだ。しかも、PowerPointなどと違って簡単にフォントサイズや行間を変更できない（らしい）ので　～そこが楽な点でもあるのだが～　原稿を修正することになる。

画像を縮めるのは、markdownではできないらしい。（markdownの画像取り込みコマンドには、サイズ指定用のパラメタは無い。）　代わりとして、画像取り込みにHTMLの<img>タグを使うことになる（と書いてあるページがたくさんあった。）

<img src="hogehoge.png", width="480px">

とかできる。

また、コンテンツを横に２つ並べること（つまり２カラム）は、これまた、できないらしい。１つ可能なのは、表を作ること。特に画像を２つ並べるときには結構便利かも知れない。あまり思ったようにはならないのだが。

markdown記法で画像を入れた場合、大きさのコントロールはできないので、大きさは左右バラバラになる。

| 例１     | 例２    | 
|:---------------:|:--------------:|
| ![](tank1.jpg)  | ![](tank2.jpg) |

大きさをコントロールしたければ、<img>タグで入れる。

|  |  |
|:--:|:--:|
| ![](w2v.png)  | <img src="w2v-mechanism.png" width="280px"> |

両方<img>にしてもよいのだが、この例では左側は元のサイズのまま。

最新の5件

2017/04/15 jupyter notebook と markdown でスライドを作るときのメモ †