- 追加された行はこの色です。
- 削除された行はこの色です。
CENTER:''Wikiで記述する方式の卒業論文作成システムの提案''
名前:小林 大輔
学籍番号:HT12A038
日付:&_date;
指導教員:兼宗 進
年度:2014
所属:総合情報学部 メディアコンピュータシステム学科
本研究では、Wikiで記述する方式の論文作成システムの提案する。
本研究では、Wikiで記述する方式の論文作成システムの提案をする。
論文執筆を行う際に使用するソフトウェアのひとつに、LaTeXがある。
これは、ユーザがTeXmakerやEmacs等のエディタに命令や文章を記述し、コンパイルをすることで出力結果を得ることができる。
しかし、LaTeXでは出力結果を予測しながら文章を作成しなければならないため、初学者がLaTeXを用いて論文を執筆することは難しい。
そこで、コンパイルをせずに出力結果を見ることが可能な論文作成システムを開発した。
これは、ユーザがTeXmakerやEmacs等のエディタに英語表記の命令や文章を記述し、コマンド実行等のコンパイル作業を行うことで出力結果を得ることができる。
しかし、初学者が複雑な命令を使用しながら、論文を執筆することは難しいと考えた。
そこで、命令を簡略化し、命令の入力量を減らすことにより、ユーザの負担を軽減できる、Wikiで記述する方式の論文作成システムを開発した。
>LaTeX PukiWiki Webブラウザ 文章変換 文章作成支援
#contents
*~はじめに 【chap1】 [#kdef7ab8]
文章を作成するためのソフトウェアには「Microsoft Word」や「Open Office Writer」、「LaTeX」等がある。
文章を作成するためのソフトウェアには「Microsoft Word」や「Open Office Writer」、「LaTeX」等がある。上記に記述したソフトウェア以外にも、様々な文章作成ソフトウェアが存在するが、論文作成には主にLaTeXを用いられることが多い。
上記に記述したソフトウェア以外にも、様々な文章作成ソフトウェアが存在するが、論文作成には主にLaTeXを用いられることが多い。
LaTeXは、ユーザがTeXmakerやEmacs等のエディタにLaTeXの命令や文章を記述したあと、コンパイル作業をすることで、PDFファイルといった閲覧用ファイルを取得することが可能である。数式を扱うのに長けており、複雑な数式を美しく出力することができ、理系の文章作成において用いられることが多い。命令は英語表記で記述し、その中にはわかりやすい命令もあれば、少し複雑な命令も存在する。
LaTeXは、ユーザがTeXmakerやEmacs等のエディタにLaTeXの命令や文章を記述したあと、コマンドラインを用いてコンパイルすることで、PDFファイルといった閲覧用ファイルを取得することが可能である。数式を扱うのに長けており、複雑な数式を美しく出力することができ、理系の文章作成において用いられることが多い。
本学科の卒業論文作成にも、LaTeXを使用することが定められている。卒業論文を書く場合、文章の内容を考え、何十ページも記述しなければならないため、複雑な命令を何度も記述するのは負担があると考えた。
そこで本研究では、Wiki形式で記述する方式の卒業論文作成システムの提案をする。本来、WikiはWebページを作成するシステムであり、独自の記法を用いて簡易的にWebページを作成できることが知られている。今回、卒業論文作成システムの構築にあたり、Wikiには存在しない記法もあったため、記法を独自で考えた。また、標準のWikiにはPDFを生成する機能はないため、提案したシステムで記述した文章を保存すると、PDFファイルを得ることも可能にした。
本学科の卒業論文作成にも、LaTeXを使用することが定められている。しかし、LaTeXの命令には複雑なものが多く、LaTeXの命令を参考書やインターネットなどで調べながら文章作成やコンパイルを行い、レイアウトなどの確認をする。卒業論文を書く場合、文章の内容を考え、何十ページも記述しなければならないため、負担が大きいと考える。
本論文では次のような構成になっている。第【【chap2】】章では、様々な文章作成ソフトウェアの説明を述べる。第【【chap3】】章では、本学科での論文執筆方法と、本研究で提案する卒業論文作成システムについて述べる。第【【chap4】】章では、論文作成システムの実装について述べる。第【【chap5】】章では、本研究で提案したシステムの使用結果と考察を述べる。第【【chap6】】章では、本研究のまとめを述べる。
そこで本研究では、Wiki形式で記述する方式の卒業論文作成システムの提案をする。Webブラウザ上で、論文作成を行えるようにすることで、環境設定の手間を省く。提案したシステムで、記述した文章を保存すると、PDFファイルを得ることも可能にした。
本論文では次のような構成になっている。第【【chap2】】章では、様々なソフトウェアの説明を述べる。第【【chap3】】章では、本学科での論文執筆方法と、本研究で提案する卒業論文作成システムについて述べる。第【【chap4】】章では、論文作成システムの実装について述べる。第【【chap5】】章では、本研究で提案したシステムの使用結果と考察を述べる。第【【chap6】】章では、本研究のまとめを述べる。
*~様々な文章作成ソフトウェア 【chap2】 [#rff8ec2b]
*Microsoft Word [#f95539a6]
Microsoft社が、WindowsおよびMac OS向けに発売している文章作成ソフトウェア(図【【word】】)である。ボタンひとつで、文字を中央に寄せたり、文字のサイズや書式を変更できる。文字や図や表の配置の自由度が高い。画像や表に対するラベル付けをし、その画像等を入れ替えた際に番号を振りなおさなければならない。
Microsoft社が、WindowsおよびMac OS向けに発売している文章作成ソフトウェア(図【【word】】)である。ボタンひとつで、文字を中央に寄せたり、文字のサイズや書式を変更できる。文字や図や表の配置の自由度が高い。
#ref(word1.png,center)
CENTER:(Microsoft Word,【word】)
*Open Office Writer [#sd1fb0da]
オープンソースで開発されたフリーの統合オフィスソフト「OpenOffice.org」の内のひとつ(図【【writer】】)。無料で利用できる。基本的な画面や操作方法は「Word」と似ているが、サポートされていない機能もある。wordと同じく、ラベル付けをした画像を入れ替えた際に番号を振りなおさなければならない。
オープンソースで開発されたフリーの統合オフィスソフト「OpenOffice.org」の内のひとつ(図【【writer】】)。無料で利用できる。基本的な画面や操作方法は「Word」と似ているが、サポートされていない機能もある。
#ref(writer1.png,center)
CENTER:(Open Office Writer,【writer】)
*LaTeX [#ndcbc411]
LaTeXとは、TeXにパッケージを組み込むことで構築されている。命令を用いて文章を作成し、コンパイルを行うことで初めてDVIやPDFなどの閲覧用のファイルを得ることが可能である。数式を綺麗に出力することが可能である。しかし、コンパイルを行わないと、どのような出力が得られるかが分かりにくい。また、文章作成の際には多くの命令が必要となるが、複雑な命令がある。
記述している文章内容と、視覚的なレイアウト情報を分けて記述し、文章を作成していくソフトウェアである。例えば、'''\section{はじめに}'''と記述すると、'''\section{}'''という命令でレイアウト情報を示し、'''{}'''の中に記述した文章が、指定された形式で出力される。英語表記の命令を用いて文章を作成し、コンパイル処理を行うことで初めてDVIやPDF等の閲覧用のファイルを得ることが可能である。
*PukiWiki [#ra4f2b88]
PukiWikiとは、独自の記法であるPukiWiki記法や文章を記述することでWebページの作成や変更が可能である。プレビューを行うことで、出力結果をすぐに見れる。また、プラグインを導入することで、様々な機能を拡張して利用できる。
Webブラウザ上で独自の記法を用いて、Webページを作成するWikiの一種である。PukiWikiでは、独自の記法であるPukiWiki記法や文章を記述することでWebページの作成、編集ができる。
*先行研究 [#ce177b82]
先行研究として、関西学院大学の吉井了平氏が行った「Wiki2LaTeXフィルターの開発」がある。この研究では、LaTeXで文章作成する際に必要な命令の一部を、PukiWikiの記法と、その他に自身で設定した記号に置き換えている。それにより、LaTeX命令の入力作業の軽減を実現している(図【【wiki2tex】】)。
先行研究として、関西学院大学の吉井了平氏が行った「Wiki2LaTeXフィルターの開発」『『yosii』』がある。この研究では、LaTeXで文章作成する際に必要な命令の一部を、PukiWikiの記法と、その他に自身で設定した記号に置き換えている。それにより、LaTeX命令の入力作業の軽減を実現している(図【【wiki2tex】】)。
PukiWiki記法をLaTeXの命令へ変換するために、既存のフィルターである「pukipa.rb」を改良している。「pukipa.rb」とは、Pukiwikiの独自文法をHTMLに変換するプログラムである。本来、HTMLに変換し出力する部分を、対応するLaTeX命令へ変更している。PukiWiki記法を用いて作成した文章を、フィルターにかけることでLaTeXの命令へ変換している。
PukiWiki記法をLaTeXの命令へ変換するために、既存のフィルターである「pukipa.rb」を改良している。「pukipa.rb」とは、Pukiwikiの独自文法をHTMLに変換するプログラムである。本来、HTMLに変換し出力する部分を、LaTeX命令を出力するように変更している。PukiWiki記法を用いて作成した文章を、フィルターにかけることでLaTeXの命令へ変換している。
この研究では頻出する命令のみに対応している。しかし、表や図など対応していない命令があるため、論文を作成することはできない。
#ref(wiki2tex2.png,center)
CENTER:(先行研究での執筆方法の比較,【wiki2tex】)
CENTER:(先行研究での文章記述方法とLaTeXへの変換後の比較,【wiki2tex】)
*~本学科の論文執筆方法と提案する方法 【chap3】 [#b51a51eb]
*本学科の論文執筆方法 [#i6dee2cf]
本学科の卒業論文の執筆には、LaTeXを扱っている。
卒業論文には様々な指定があり、指定通りに論文を作成するには、表【【iru】】中の項目や命令が必要である。
卒業論文には様々な指定があり、指定通りに論文を作成するには、以下の項目や命令が必要である。
CENTER:(論文作成に必要な項目や命令,【iru】)
-表紙
-タイトル
-著者
-指導教員
-日付
-学籍番号
-年度
-所属学部学科
-概要
-目次
-章立て
-日付
-表紙
-章
-節
-付録
-ラベル
-参照
-ページ番号の設定
-学籍番号
-指導教員
-年度所属学部学科
ページ番号の書式の設定
以上の項目や命令に対応する必要がある。
*提案する方法 [#e784ced6]
LaTeXは、インターネットからインストール等の、環境設定をする必要がある。その後、TeXmakerやEmacs等のエディタに、複雑な命令を入力し文章を作成しなければならない。また、コンパイルしなければどのような出力が得られるのかわからない。先行研究では、LaTeXの複雑な命令の入力を簡略化することでユーザの負担は軽減しているが、このシステムのみでは、表や図に対応していないため、LaTeXの命令を記述せずに論文を作成することはできない。
第【【chap1】】章でも述べたが、LaTeXはTeXmakerやEmacs等のエディタに、英語表記の命令を入力し文章を作成する。命令にはわかりやすいものもあるが、複雑なものもある。複雑な命令を何度も記述するのは、慣れていないユーザには負担がかかると考えた。先行研究では、LaTeXの命令の入力を簡略化することで、ユーザへの負担は軽減している。しかし、表や図に対応していないため、このシステムのみではLaTeXの命令を記述せずに論文を作成することはできない。
そこで、環境設定が不要なWebブラウザを用いる。ボタンひとつで出力結果が得られ、ひとつのシステムのみでPDFファイルを作成することが出来る。
以上の機能がある論文作成システムを提案をする。
そこで、論文作成に必要な命令を独自に簡略化する。また、作成した文章を保存することで、PDFファイルを作成する。これらの機能がある論文作成システムを提案をする。例として、図の挿入時に記述する命令を、提案する命令と、LaTeXの命令の文章を比較する(図【【inc】】)。命令を簡略化することで、負担を軽減できると考えられる。
従来の論文作成方法と、今回提案する論文作成方法を図【【texwiki】】に示す。
#ref(texwiki.png,center)
CENTER:(従来の方法と今回の提案,【texwiki】)
#ref(inc.png,center)
CENTER:(図の挿入命令の比較,【inc】)
*~研究内容 【chap4】 [#a8a88a9d]
*システムの概要 [#tbe2e096]
本研究で提案するシステムはPukiWikiをベースに作成した。提案するシステムでは、文章の記述の際にはPukiWiki記法を用いる。PukiWiki記法を用いて作成した文章をLaTeX形式へ変換することでコンパイルが可能な形式になる。しかし、変換するだけではPDFでの出力結果を見ることができないため、ページ更新ボタンを押すことで、PDFファイルを作成できるようにした。
本研究で提案するシステムはPukiWikiをベースに作成する。提案するシステムでの文章の記述には、PukiWiki記法と、独自に提案する記法を用いる。PukiWiki記法を用いて作成した文章をLaTeX形式へ変換するプログラムの作成をする。その後、PDFファイルを作成できるようにした。
*対応方法 [#na0f25b5]
Pukiwikiは本来Webページの作成に用いられる。一方、LaTeXは論文作成のために用いられる。両者の利用目的が異なるため、必ずPukiWiki記法とLaTeXの命令が一致するとは限らない。最初に、命令と記法の意味が一致しているものから対応付けをし、その後、命令と記法が一致しなかったものの記法を新たに作成し、対応付けをした。
Pukiwikiは本来、Webページの作成に用いられる。一方で、LaTeXは論文作成のために用いられる。両者の利用目的が異なるため、必ずPukiWiki記法とLaTeXの命令が一致するとは限らない。そのため、命令と記法が一致しなかった記法を独自に作成し、対応付けをした。
LaTeXで文章作成を行う際に頻出する命令と、Pukiwiki記法との対照表の一部を、表【【lists】】に示す。
例えば、LaTeXには内容梗概('''{abstract}''')という命令があるが、PukiWikiにはそのような記法はない。そのため、文頭に半角スペースを入力することで内容梗概を暗示させる。LaTeXで文章作成を行う際に必要な命令と、PukiWiki記法との対照表を表【【lists】】に示す。
CENTER:(PukiWiki記法とLaTeX命令の対照表,【lists】)
|LEFT:Pukiwiki記法|LEFT:LaTeX命令(始まり)|LEFT:LaTeX命令(終わり)|LEFT:意味|
|LEFT:'''*'''|LEFT:'''\section'''|LEFT:なし|LEFT:見出し|
|LEFT:'''*~'''|LEFT:'''\chapter'''|LEFT:なし|LEFT:章|
|LEFT:'''*'''|LEFT:'''\section'''|LEFT:なし|LEFT:節(大)|
|LEFT:'''**'''|LEFT:'''\subsection'''|LEFT:なし|LEFT:節(中)|
|LEFT:'''***'''|LEFT:'''\subsubsection'''|LEFT:なし|LEFT:節(小)|
|LEFT:'''+'''|LEFT:'''\begin{enumerate}'''|LEFT:'''\end{enumerate}'''|LEFT:番号付リスト|
|LEFT:'''-'''|LEFT:'''\begin{itemize}'''|LEFT:'''\end{itemize}'''|LEFT:番号なしリスト|
|LEFT:|a|b||LEFT:'''\begin{table}'''|LEFT:'''\end{table}'''|LEFT:表組み|
|LEFT:'''#ref'''(ファイル名)|LEFT:'''\begin{figure}'''|LEFT:'''\end{figure}'''|LEFT:図|
|LEFT:'''#ref'''(ファイル名)|LEFT:'''\begin{figure}'''|LEFT:'''\end{figure}'''|LEFT:図の挿入|
|LEFT:'''【''' 】|LEFT:'''\label{}'''|LEFT:なし|LEFT:ラベル|
|LEFT:'''【''' '''【''' '''】''' 】|LEFT:'''\ref{}'''|LEFT:なし|LEFT:参照|
|LEFT:文頭に半角スペース|LEFT:'''\begin{abstract}'''|LEFT:'''\end{abstract}'''|LEFT:内容梗概|
|LEFT:'''#'''contents|LEFT:'''\maketitle'''|LEFT:なし|LEFT:目次|
|LEFT:'''----'''|LEFT:'''\appendix'''|LEFT:なし|LEFT:付録|
|LEFT:'''CENTER''':""タイトル""|LEFT:'''\title'''|LEFT:なし|LEFT:タイトル|
PukiWikiでのプレビュー時に、Webブラウザ上に表示される文章やレイアウトを見ることで、PDFファイルの出力結果をイメージできるように対応付けをした。
LaTeXとPukiWikiで一致しないものについては、それぞれの意味が異なる場合でも対応させている。例えば、LaTeXには概要('''{abstract}''')という命令があるが、PukiWikiにはそのような記法はない。そのため、文頭に半角スペースを入力することで概要を暗示させる。PukiWikiでのプレビュー時に、Webブラウザ上に表示される文章やレイアウトをLaTeX形式を似せることでPDFのイメージができるようにした。
**章立て [#sa221d8e]
LaTeXには「章立て('''\chapter''')」や「見出し('''\section''')」という命令がある。しかし、PukiWiki記法には「章立て」はなく「見出し(*)」しかない。PukiWiki上では「*」を使用しなければプレビュー時に目次に表示されない為、見出しと章立てを「*」を用いた記述方法にした。しかし、PukiWiki記法では「***(LaTeXでいう'''\subsubsection''')」までしか対応されていない。そのため、「'''****'''」とは、記述することができない。そこで、文頭に「'''*~'''」と記述すると「章立て」とし、「見出し(*)」部分と区別するようにした(図【【chapsec】】参照)。
LaTeXには「章('''\chapter''')」や「節('''\section''')」という命令がある。しかし、PukiWiki記法には「章」はなく「節(*)」しかない。PukiWiki上では「*」を使用しなければプレビュー時に目次に表示されないため、節と章を「*」を用いた記述方法にした。しかし、PukiWiki記法では「***(LaTeXでいう'''\subsubsection''')」までしか対応されていない。そのため、「'''****'''」とは、記述することができない。そこで、文頭に「'''*~'''」と記述すると「章」とし、「節(*)」部分と区別するようにした(図【【chapsec】】参照)。
#ref(chapsec.png,center)
CENTER:(編集画面とプレビュー,【chapsec】)
**ラベルと参照 [#jec6f048]
PukiWikiには文章や画像・表などにラベルを付け、参照するという記述法はなく、それぞれにアンカーやリンクを付けるといった命令しかない。
対照できない場合は、PukiWikiのページ上や文章中に存在しても違和感がなく、かつ、文章作成中に使用しない記号を使用する必要があった。
今回は、ラベル('''\label''')と参照('''\ref''')をイメージさせるために、ラベルの代わりにすみつきカッコ('''【''' '''】''')と('''【''' '''【''' '''】''' 】)を用いた(図【【labref】】参照)。
今回は、ラベル('''\label''')の代わりにすみつきカッコ('''【''' '''】''')と参照('''\ref''')の代わりに('''【''' '''【''' '''】''' 】)を用いた(図【【labref】】参照)。
#ref(labref.png,center)
CENTER:(PukiwWikiでのラベルと参照,【labref】)
**図の挿入 [#uc15a163]
図を挿入する際には、一度PukiWiki上に画像ファイルをアップロードし、('''#'''ref(画像ファイル名),図の位置)と記述するとPukiWiki上に図が表示される。PukiWikiではファイル名がその図の表示名になってしまうため、表示名を出力する命令を考え実装した(図【【ref1】】参照)。(*jpg)や(*.png)のファイルは画像が表示される。(*.eps)についてはファイル名のみが表示され、クリックすることで表示することが可能である。アップロード可能最大ファイルサイズは1,024KBである。
図を挿入する際には、一度PukiWiki上に画像ファイルをアップロードし、('''#'''ref(画像ファイル名),図の位置)と記述するとPukiWiki上に図が表示される。PukiWikiではファイル名がその図の表示名になってしまうため、表示名を出力する命令を考え実装した(図【【ref1】】参照)。画像が表示できるのは拡張子が(*.jpg)や(*.png)のファイルで、(*.eps)についてはファイル名のみが表示され、クリックすることで表示することが可能である。
LaTeXの命令へ変換しPDFにする場合にはTeXファイル(*.tex)と同じフォルダ内に画像ファイルを挿入しておく必要がある。
図【【ref1】】中の数字の説明は、1がPukiwikiでの図を挿入する命令。2で図の下部に表示名とラベルを表示している。
#ref(wikiref3.png,center)
CENTER:(図の挿入,【ref1】)
**表の挿入 [#cd8d7329]
表を挿入する際、PukiWikiでは非常に直感的な記述が可能である。しかし、通常の記述方法では、図と同様に、表示名やラベルを記述することが出来ない為、表示名とラベルの記述方法を考え実装した(図【【tab1】】)。
表を挿入する際、PukiWikiでは非常に直感的な記述が可能である。しかし、通常の記述方法では、図と同様に、表示名やラベルを記述することが出来ないため、表示名とラベルの記述方法を考え実装した(図【【tab1】】)。
図【【tab1】】中の数字は、1がPukiwikiで表を挿入する命令。2で表の上部のタイトルとラベルを表示している。
#ref(tab2.png,center)
CENTER:(表の挿入,【tab1】)
**タイトルなど表紙に記述する内容 [#jb2fb2ba]
論文には、タイトルや著者名や日付が必要である。他にも、卒業論文では、学籍番号や指導教員名、所属学科などを記述する必要がある。タイトルは最上の中央部に太字で出力し、日付はPukiWiki記法で標準で扱えるものを使用する。著者名や学籍番号等の記述方式は似せるようにした(図【【title】】)。
論文には、タイトルや著者名、日付が必要である。他にも、卒業論文では、学籍番号や指導教員名、所属学科などを記述する必要がある。タイトルは最上の中央部に太字で出力し、日付はPukiWiki記法で標準で扱えるものを使用する。著者名や学籍番号等の記述方式は似せるようにした(図【【title】】)。
#ref(title2.png,center)
CENTER:(表紙に記述する文章,【title】)
*処理内容 [#xcb81867]
**主な処理内容 [#ied52cf1]
PukiWiki記法を、LaTeXの命令へ変換するプログラムを、Perl言語を用いて作成した。下記はPukiWiki記法で箇条書きを使用した際に、変換プログラムが行う処理である。
+ 文頭の記号を判別し、'''\begin{itemize}'''を出力する
+ 文頭の記号を'''\item'''へ変換する
+ 文頭に対応する記号が無い行で'''\end{itemize}'''を出力する
*プログラムの処理 [#xcb81867]
**主なプログラムの処理方法 [#ied52cf1]
プログラムはPerlを用いて作成した。下記はPukiWikiで箇条書きを使用した際に、プログラムが行う処理である。
+ 文頭の記号を判別し、変数の値が0の場合、'''\begin{itemize}'''を出力する
+ 文頭の記号を'''\item'''へ変換し、変数の値を+1する
+ 文頭に対応する記号が無い行、かつ変数の値が0以上であれば'''\end{itemize}'''を出力し変数の値を0にする
この処理を行った際の、変換前(PukiWiki)と変換後(LaTeX)の比較を図【【item】】に示す。
LaTeX側で複数行に渡り記述する命令については、このような処理をベースとしている。
#ref(itempl.png,center)
CENTER:(箇条書きの変換前と変換後の比較,【item】)
その他、タイトル('''\title''')や目次('''\tableofcontents''')等、一行で判別が可能な命令については、文頭や文中に特定の文字や記号が存在した際に、LaTeXの命令に変換している。
**図の挿入 [#w618d4ad]
LaTeXでの図の挿入時には、図を表示させる、図の場所を指定する、図のタイトルを出力する命令、場合によってラベルを付与する必要がある。
Pukiwikiでの入力(図【【lab1】】)をLaTeXの命令(図【【lab2】】)へあてはめていく処理を行っている。
PukiWikiでの入力(図【【lab1】】)をLaTeXの命令(図【【lab2】】)へあてはめていく処理を行っている。
図【【lab1】】と図【【lab2】】中の数字は、1がファイル名、2が図を表示する位置、3が図のタイトル、4がラベルとなっている。
#ref(labnew.png,center)
CENTER:(Pukiwikiでの図の表示,【lab1】)
#ref(labnew1.png,center)
CENTER:(TeX命令へ変換後,【lab2】)
**表の挿入 [#fbe9d70b]
LaTeXで表の挿入を行う場合も、図の挿入のように複雑である。表をどの位置に出力するか、表中の要素の位置指定、表のタイトルを出力、ラベルを付与させるなどの命令が必要である。
PukiWiki記法では、各要素の位置指定を一つずつしなければならない。しかし、LaTeXの命令では列ごとに要素の位置指定が可能である。そのため、PukiWikiで表の一行目に記述した位置指定を、変換後にはそれぞれの列の位置指定としている(図【【table1】】、図【【table2】】参照)。
#ref(table1.png,center)
CENTER:(表の挿入(PukiWiki記法),【table1】)
#ref(table3.png,center)
CENTER:(表の挿入(LaTeX命令),【table2】)
**アンカーの削除 [#z04c279c]
PukiWikiでは、ページ更新をした際に、見出し(*)を使用した文末にアンカーが付属してしまう(図【【ancer】】参照)。アンカーを放置したまま、LaTeX形式に変換しターミナルなどでコンパイルをするとエラーが出てしまうため、LaTeX形式に変換する際にそのアンカーを削除する必要があった。文章作成時にアンカーのような文章を記述してしまうと、アンカーと同様に削除してしまう恐れがあった為、文頭が「*」で文末に特定の文字列が存在した場合のみ、アンカーを削除するようにした(図【【texanc】】参照)。
PukiWikiでは、ページ更新をした際に、見出し(*)を使用した文末にアンカーが付属してしまう(図【【ancer】】参照)。アンカーを放置したまま、LaTeX形式に変換しターミナルなどでコンパイルをするとエラーが出てしまうため、LaTeX形式に変換する際にそのアンカーを削除する必要があった。文章作成時にアンカーのような文章を記述してしまうと、アンカーと同様に削除してしまう恐れがあったため、文頭が「*」で文末に特定の文字列が存在した場合のみ、アンカーを削除するようにした(図【【texanc】】参照)。
#ref(ancer.png,center)
CENTER:(ページ更新前と更新後の比較,【ancer】)
#ref(texanc3.png,center)
CENTER:(アンカー削除:変換前と変換後の比較,【texanc】)
**プリアンブルの付与 [#rb5fb635]
LaTeXは、「プリアンブル」をテキストファイルに記述しなければコンパイルすることが出来ない。そのため、今回は卒業論文で使用するプリアンブルを変換プログラムにかけた際に、自動で付与している(図【【puri】】参照)。その際に'''\begin{document}'''も一緒に付与し、'''\end{document}'''は文章の最後に付与している。これによりコンパイルが可能になる。
LaTeXは、「プリアンブル」をテキストファイルに記述しなければコンパイル処理をすることが出来ない。そのため、今回は卒業論文で使用するプリアンブルを、変換プログラムにかけた際に、自動で付与している(図【【puri】】参照)。その際に'''\begin{document}'''も一緒に付与し、'''\end{document}'''は文章の最後に付与している。これによりコンパイル処理が可能になる。
#ref(puri3.png,center)
CENTER:(プリアンブルの付与,【puri】)
**表紙やページ番号の付与 [#y92f9e5c]
論文を印刷した際に、表紙やページ番号がついていないと非常に見にくくなってしまう。しかし、PukiWiki記法はWebページを作成する言語であるため、表紙やページ番号を付与させるような命令はない。そのため、LaTeXの命令に変換した際に、特定の命令の前後にページ番号などの命令を付与させるようにした。
論文を印刷した際に、表紙やページ番号がついていないと非常に見にくくなってしまう。しかし、PukiWiki記法はWebページを作成する記法であるため、表紙やページ番号を付与させるような命令はない。そのため、LaTeXの命令に変換した際に、特定の命令の前後にページ番号などの命令を付与させるようにした(図【【pagenumber】】参照)。
概要を記述すると、表紙と概要ページのページ番号を出力する命令を付与する。目次を記述すると、目次以下のページ番号を決められた書式で出力する命令を付与する(図【【pagenumber】】参照)。
しかし、変換した際に決められたページ番号を出力するため、現在はページ番号の書式の設定はできない。
しかし、プログラムが自動的に決められたページ番号を出力する為、現在はページ番号の書式の設定などは出来ていない。
#ref(page3.png,center)
CENTER:(表紙やページ番号の出力,【pagenumber】)
*変換の自動化 [#sff4f0c7]
LaTeXは、作成した文章をコンパイルしなければPDFファイルなどの出力結果が得られない。PukiWikiでは、ボタンひとつで出力することができるが、PDFファイルを作成するためには、PukiWiki記法を用いて作成した文章を、LaTeX形式に変換しなければコンパイル可能な形式にならない。PukiWiki記法をLaTeX形式に変換し、コマンドラインで、platexを使い、dviファイルを作成。その後、dvipdfmxを使い、PDFファイルにする。これらの作業を自動化する。
PukiWikiでは、文章の作成やレイアウトの確認はできるが、PDFファイルを作成することはできない。PDFファイルを作成するためには、PukiWiki記法を用いて作成した文章を、LaTeX形式に変換する、そのLaTeX形式の文章をコンパイル作業を行いPDFファイルにする。しかし、これでは手間がかかってしまう。そこで、これらの作業を自動化する。
自動化の際、2つの方法を試みた。1つはサーバを用いた方法である。本研究で使用しているPukiwikiが動作しているサーバではLaTeXが起動しなかった。そのため、他のサーバを扱うことも考えたが、データ取得の際にユーザに負担がかかってしまう。
Pukiwikiで編集している文章を保存することで、LaTeX形式の文章へ変換し、そのLaTeX形式の文章をコンパイル処理することでPDFファイルになる。そのPDFファイルを保存する。
その提案を実現するために、シェルスクリプトを用いてプログラムを作成する。
2つ目に、Dropboxを用いた方法を試みた。Dropboxでは、複数のコンピュータの間で、データの共有や同期が可能である。自身でサーバにアクセスし、データを移動させるより、自動的に自身のPCに同期されるDropboxの方が便利である。ページ更新ボタンを押した際に、Pukiwikiで編集している文章をLaTeX形式の文章へ変換し、そのLaTeX形式の文章をコンパイルすることでPDFファイルになる。そのPDFファイルをDropboxのフォルダ内に保存する。
その提案を実現するために、シェルスクリプトを用いてプログラムを作成した。
自動化を行うために、rsyncコマンドと「a」オプションを使うことにより、タイムスタンプを保持したまま、変更されたファイルのみをコピーすることができる。このコマンドを用いて、サーバ内に存在するPukiWikiのWikiディレクトリを、タイムスタンプを保持したまま、変更されたファイルのみをコピーする。タイムスタンプが更新されてしまうと、タイムスタンプの比較が正常にできなくなってしまう。
自動化を行うために、LaTeXをコンパイルするために用いるフォルダ内のファイルと、Pukiwikiで文章作成を行っているページで、更新時刻が新しくなった修正されたファイルだけをコピーする。この処理を、シェルスクリプトのrsyncコマンドを用いて行う。
「ファイル名.txt」が「ファイル名.tex」より新しくなっていた場合は、「ファイル名.txt」を変換プログラムにかけ、LaTeX命令へ変換し、「ファイル名.tex」へ書き込む。platexでtexファイルを2回コンパイル処理し、エラーが出れば次の処理には移らず、エラーが出なければdvipdfmxでコンパイル処理を行いPDFファイルを作成する。以上の処理を30秒ごとに行う。
本研究で作成した、PukiWiki記法をLaTeXの命令へ変換するプログラムであるsample.plと、それを複製したw2t.plを用意する。PukiWikiで更新ボタンが押された際に、sample.plが更新されているかチェックし、構文エラーが無ければ、w2t.plと見比べ、sample.plがw2t.plより新しくなっている場合、sample.plの文字コードを変更しw2t.plへ書き換える。
その後、PukiWikiで文章作成時に更新されているページのリストを変数に入れる。値リスト.txtと、Dropbox内に存在するの値リスト.texを見比べる。値リスト.txtの方が新しい場合、そのテキストファイルを変換プログラムでLaTeX命令に変換しtexファイルへ書き換える。その後、2回コンパイルを行う。その際にエラーが出現した場合は、コンパイルを中止。エラーが出現しない場合はPDFファイルを生成する。上記の作業を30秒ごとに行う。
この処理をフローチャートに示したものが図【【flow】】である。
#ref(flow1.png,center)
#ref(flow3.png,center,max)
CENTER:(自動化プログラムの流れ,【flow】)
*~使用結果 【chap5】 [#cce84965]
作成したシステムによって、本論文を作成した。本システムでは、LaTeXのように細かい指定等はできないが、簡略化した命令を用いるため、文章の作成を容易に行うことができた。また、プレビューを行うことで、出力結果をイメージすることができ、全体の構成を確認しながら執筆を進めることができた。今後の課題として以下の点が挙げられる。
*~使用結果と今後の課題 【chap5】 [#cce84965]
本研究では、Wikiで記述する方式の卒業論文作成システムを作成した。本システムを扱い、本論文を作成した。Webブラウザに表示される文章やレイアウトをLaTeX形式を似せることでPDFのイメージできるようにした。また、ページ更新ボタンを押すだけでPDFファイルが作成し、Dropboxへ更新されるため、コンパイルを行う手間を省けたのではないかと考える。
+箇条書きを入れ子にできない
+表や図のサイズや、文章のサイズなど細かい指定ができない
+パッケージの追加などには未対応である
+プリアンブルが規定されたものしか付与できない
+ページ番号も規定されたものしか付与できない
+プレビューをすると、編集画面の上部にプレビューが表示されるため再編集時には、最下部までスクロールしなければならない
+数式に対応できていない
+行番号がないので編集時にわかりにくい
今後の課題として
-箇条書きを入れ子にできない
-パッケージの追加などには未対応である
-プリアンブルが規定されたものしか付与できない
-ページ番号も規定されたものしか付与できない
-表や図のサイズや、文章のサイズなど細かい指定ができない
-プレビューをすると、編集画面の上部にプレビューが表示されるため
-数式に対応できていない
-行番号がないので編集時にわかりにくい
-PDFのファイル名がPukiwikiで作成したファイル名と違う
課題に対する解決策として、1から5までは変換プログラムの改良が必要である。6から8までの課題を解決するためには、PukiWikiを改良しなければならない可能性が高いので検討する必要がある。
以上が挙げられる。
課題に対する改良案として、作成したプログラムの見直しが必要であると考える。数式対応については、PukiWikiにプラグインを導入し、そのためのプログラムを作成することで解決可能であると考える。スクロールや行番号問題に対しては、PukiWikiを改良しなければならない可能性が高いので検討する必要がある。PDFのファイル名については、文字解析を行い、正確な名称に変換する必要がある。これはシェルスクリプトのプログラムを改良することで、解決可能だと考える。
*~おわりに 【chap6】 [#ef19b892]
本研究では、Wiki形式で記述する方式の卒業論文作成システムの提案した。
LaTeXの命令には複雑なものが多く、LaTeXの命令を参考書やインターネットなどで調べながら文章作成やコンパイルを行い、レイアウトなどの確認をする。卒業論文を書く場合、文章の内容を考え、何十ページも記述しなければならないため、負担が大きいと考えた。
そこで、Pukiwiki記法を用いて作成した文章を、LaTeX形式へ変換するプログラムを作成した。また、PukiWikiのページ更新ボタンを押すことで、Dropboxのフォルダ内にPDFファイルを作成するプログラムを実装した。
本システムの構築にあたり、PukiWiki記法と独自に提案した記法を用いて作成した文章を、LaTeX形式へ変換するプログラムを作成した。
本研究で作成したシステムでは、本学科指定の卒業論文を作成することができる。
本システムにより、本論文を作成した。簡略化した命令を使用できる、かつ、プレビューにより、出力結果をイメージすることができ、全体の構成を確認しながら執筆を容易に進められることを確認できた。
また、論文が受理されたことから、本学科指定の卒業論文を作成することができたといえる。
今回、本論文をこのシステムで作成するにあたり、使用できない命令や、細かい指定が出来ない等の課題を発見することが出来た。
今後は、発見した課題を解決していきたい。そして、このシステムが論文作成の際にユーザにかかる負担を軽減できるのか検証を行いたい。
今後は、発見した課題を解決していきたい。そして、このシステムが論文作成の際にユーザにかかる負担を軽減できるのか、さらなる検証を行いたい。
*~謝辞 [#t76c9886]
本研究、本論文を終えるにあたり、御指導・御教授を頂いた兼宗進教授に深く感謝いたします。
本研究、本論文を終えるにあたり、多大なる御指導、御教授をいただいた、兼宗進教授に深く感謝致します。
また、学生生活における基礎的な学問、学問に取り組む姿勢をご教授頂いた、メディアコンピュータシステム学科の先生方に深く感謝致します。
また、学生生活における基礎的な学問、学問に取り組む姿勢を御教授いただいた、メディアコンピュータシステム学科の先生方に深く感謝致します。
また、本研究を進めるにあたり御教授いただきました、下倉雅行先生に深く感謝致します。
本研究期間中、本研究に対する貴重な御意見、御協力を頂きました島袋舞子氏に感謝致します。そして、卒業研究に共に励んだ兼宗研究室メンバー一同に感謝します。
本研究期間中、本研究に対する貴重な御意見、御協力をいただきました、島袋舞子氏に感謝致します。そして、卒業研究に共に励んだ兼宗研究室メンバー一同に感謝します。
((奥村 俊之. LaTeX2ε美文書作成入門. 技術評論社, 2010.,【texx】))
((吉井 了平. Wiki2LaTeXフィルターの開発. &br;http://ist.ksc.kwansei.ac.jp/'''~'''nishitani/'''?'''MBTheses. , 2010. ,【yosii】))
((増井 俊之. Perl書法. 株式会社アスキー, 1993.,【pel】))
((Perl基礎入門|KenTWeb. http://www.kent-web.com/perl/. ,【perl2】))
((FrontPage-PukiWiki-official. http://pukiwiki.sourceforge.jp/. ,【pukipuki】))
((奥村 晴彦.LaTeX2ε 美文書作成入門.技術評論社.[1997-2010].,【tex】))
((吉井 了平.Wiki2LaTeXフィルターの開発.[2010].,【yosii】))
((増井 俊之.Perl書法.[1993].,【perl】))
((Perl基礎入門 | KentWeb '''http://www.kent-web.com/perl/''',【perl2】))
((Uge.jp いつもWebにリファレンス '''uge.jp''',【uge】))
----
*~プログラムリスト [#h12a62c8]
:sample.pl|[perlファイル,【pl22】]
:sample.pl|[変換プログラム,【pl22】]
:w2t.sh|[自動化プログラム,【sh】]
<<<
my $ti=0; #タイトル
my $abst=0; #概要
my $tc=0; #table
my $ic=0; #item
my $ec=0; #enumarete
my $ac=0; #abst
my $clc=0; #chapter.labe
my $slc=0; #section.label
my $anc=0; #sectoin ancor
my $sanc=0; #sub anc
my $ssanc=0; #subsub anc
my $ref=0;
my $bibi=0;
my $fig=0;
my $tab=0;
print "\\documentclass\[11pt\]\{oecu-thesis\}\n";
print "\\usepackage\{times\}\n";
print "\\usepackage\[dvipdfmx\]\{graphicx,color\}\n";
print "\\newcommand\{\\tag\}\[1\]\{\$\\langle";
print "\$\\nobreak\#1\\nobreak\$\\rangle\$\}\n";
print "\\newcommand\{\\stereotype\}\[1\]\{\\raisebox\{0.45ex\}\{\$\_\\ll\$\}
\\nobreak\n";
print "\#1\\nobreak\\raisebox\{0.45ex\}\{\$\_\\gg\$\}\}\n";
print "\\begin\{document\}\n";
while (<>){
chomp;
$count = (() = $_ =~ /\|/g);#"|"の数をカウント
#べた書き
if(/\'\'\'(.*)\'\'\'/){
s/\'\'\'(.*?)\'\'\'/\\verb\+\1\+/g;
}
#図
if(/\#ref\((.*?),(.*?)\)/){
s/\#ref\((.*?),(.*?)\)//;
print "\\begin\{figure\}\[h\]\n\\begin{$2}\n";
print "\\includegraphics[width=0.8\\textwidth]{$1}";
$fig = 1;
}elsif(/CENTER\:\((.*?),\【(.*?)\】\)/ && $fig == 1){
s/CENTER\:\((.*?),\【(.*?)\】\)//;
print "\\caption{$1}\\label{$2}\n\\end{center}\n\\end{figure}\n";
$fig = 0;
}
#表
if(!/^\|/ && $tab != 0){
print " \\end\{tabular\}\n";
print " \\end{center}\n";
print "\\end\{table}\n";
$tab=0;
}elsif(/^CENTER:\((.*?),\【(.*?)\】\)/){
print "\\begin{table}[h]\n";
print " \\begin{center}\n";
print " \\caption{$1}\\label{$2}";
s/^CENTER:\((.*?),\【(.*?)\】\)//;
$tab++;
}elsif(/^\|/ && $tab == 1){
$str = $_;
$str2 = $str;
if($count != 0){
print " \\begin{tabular}{";
s/\|//;
for($j = 1; $j < $count; $j++){
print "|";
s/(.*?)\|//;
if($1 =~ /CENTER:/){
print "c";
}elsif($1 =~ /RIGHT:/){
print "r";
}elsif($1 =~ /LEFT:/){
print "l";
}else{
print "l";
}
}
print "|} \\hline\n";
$tab++;
}
$str2 =~s/RIGHT:|CENTER:|LEFT://g;
$str2 =~ s/^\|//g;
$str2 =~ s/\|/\&/g; #gはマッチするものを全て置換
chop($str2);
print " ";
print $str2 . " \\\\ \\hline";
s/.*//;
}elsif($tab != 0 && $count != 0){
$str = $_;
$str =~s/RIGHT:|CENTER:|LEFT://g;
$str =~ s/^\|//g;
$str =~ s/\|/\&/g; #gはマッチするものを全て置換
chop($str);
print " ";
print $str . " \\\\ \\hline";
s/.*//;
}
#改行
if(/\&br\;/){
s/\&br\;/\\\\/g;
print $_;
}
#参照
elsif(/『『.*』』/){
s/『『(.*?)』』/\\cite\{\1\}/g;
#print $_;
}
#タイトル
if(/^CENTER:/ && /\'\'/){
s/^CENTER: *(.*)/\\title\{\1\}/;
s/\'\'//g;
#print $_ . "\n";
}
#参考文献
if(!/^\(\(/ && $bibi != 0){
print "\\end\{thebibliography\}\n";
$bibi=0;
}elsif(/\(\((.*?),\【(.*?)\】\)\)/ && $bibi == 0){
print "\\begin{thebibliography}{999}\n";
print "\\bibitem\{$2\}$1" . "\n";
$bibi++;
}elsif(/\(\((.*?),\【(.*?)\】\)\)/ && $bibi >= 1){
print "\\bibitem\{$2\}$1" . "\n";
}
#参照
elsif(/【【.*】】/){
s/【【(.*?)】】/\\ref\{\1\}/g;
print $_;
}
#ラベル
elsif(/【.*】/){
s/【(.*?)】/\\label\{\1\}/g;
print $_;
}
elsif(/^\<\<\</){
s/^\<\<\</\\begin\{verbatim\}/g;
print $_;
}
elsif(/^\>\>\>/){
s/^\>\>\>/\\end\{verbatim\}/g;
print $_;
#keyword
elsif(/^\>(.*?)/){
s/\>/\\keywords\n/;
s/ /\\quad\n/g;
print $_ . "\n";
}
#学生番号
elsif(/^学生番号\:/){
s/^学生番号: *(.*)/\\学生番号\{\1\}/;
print $_ . "\n";
}
#指導教員
elsif(/^指導教員:/){
s/^指導教員: *(.*)/\\指導教員\{\1 教授\}/;
print $_ . "\n";
}
#付録
elsif(/----/){
s/----/\\appendix\n/;
print $_;
}
#著者
elsif(/^名前:/){
s/^名前: *(.*)/\\author\{\1\}/;
print $_ . "\n";
}
elsif(/^名前:/){
s/^名前:*(.*)/\\author\{\1\}/;
print $_ . "\n";
}
#日付
elsif(/^日付\:/){
s/^日付\:\&_date;/\\date\{\\today\}/;
print $_ . "\n";
}
#日付
elsif(/^日付:/){
s/^日付\:\&_date;/\\date\{\\today\}/;
print $_ . "\n";
}
#年度
elsif(/^年度:/){
s/^年度\: *(.*)/\\年度\{\1\}/;
print $_ . "\n";
}
#所属
elsif(/^所属:/){
s/^所属\: *(.*)/\\所属\{\1\}/;
print $_ . "\n";
}
#概要
elsif(/^ / && $abst >= 1){
s/^ //;
print $_ . "\n";
$abst++;
}elsif(/^ /){
if($abst == 0){
print "\\maketitle\n";
print "\\pagenumbering\{roman\}\n";
print "\\begin\{abstract\}\n";
s/^ //;
print $_ . "\n";
$abst++;
}
}
#箇条書き
elsif(!/^-/ && $ic > 0){ #先頭が-じゃない場合
print "\\end\{itemize\}\n";
$ic=0;
}elsif(!/^\+/ && $ec > 0){ #先頭が+じゃない場合
print "\\end\{enumerate\}\n";
$ec=0;
}elsif($ic >= 1){
s/^\-/\\item /;
print $_ . "\n"; #読み込んでる一行
$ic++;
}elsif(/^-/){
if($ic == 0){
print "\\begin\{itemize\}\n";
s/^\-/\\item /;
print $_ . "\n"; #読み込んでる一行
$ic++;
}
}
#begin{enumerate}
elsif($ec >= 1){
s/^\+/\\item /;
print $_ . "\n";
$ec++;
}elsif(/^\+/){
if($ec == 0){
print "\\begin\{enumerate\}\n";
s/^\+/\\item /;
print $_ . "\n"; #読み込んでる一行
$ec++;
}
}
#*の後の[]を消す
#謝辞
elsif(/^\*\~謝辞/ && /\[.*\]/){
s/ \[.*\]//;
s/^\*\~謝辞/\\acknowledgment/;
print $_ . "\n";
}elsif(/^\*\*\*/ && /\[.*\]/){
$ssanc = $_;
$ssanc =~ s/ \[.*\]//;
$ssanc =~ s/^\*\*\* *(.*)$/\\subsubsection\{\1\} /;
print $ssanc . "\n";
}elsif(/^\*\*\*/){
s/^\*\*\* *(.*)$/\\subsubsection\{\1\} /;
print $_ . "\n";
}elsif(/^\*\*/ && /\[.*\]/){
$sanc = $_;
$sanc =~ s/ \[.*\]//;
$sanc =~ s/^\*\* *(.*)$/\\subsection\{\1\} /;
print $sanc . "\n";
}elsif(/^\*\*/){
s/^\*\* *(.*)$/\\subsection\{\1\} /;
print $_ . "\n";
}elsif(/^\*\~/ && /\\label\{.*\}/ && /\[\#.*\]/){
s/ \[\#.*]//;
s/^\*\~ *(.*?)(\\label\{.*\})/\\chapter\{\1\} \2/;
print $_ . "\n";
}elsif(/^\*\~/ && /\[.*\]/){
s/ \[.*\]//;
s/^\*\~ *(.*?)$/\\chapter\{\1\}/g;
print $_ . "\n";
}elsif(/^\*\~/){
s/ \[.*\]//;
s/^\*\~ *(.*)/\\chapter\{\1\}/;
print $_ . "\n";
}elsif(/^\*/ && /\\label\{.*\}/ && /\[.*\]/){
$anc = $_;
$anc =~ s/ \[.*\]//;
$anc =~ s/^\* *(.*?)(\\label\{.*\})/\\section\{\1\} \2/g;
print $anc . "\n";
}elsif(/^\*/ && /\[.*\]/){
s/ \[.*\]//;
s/^\* *(.*?)$/\\section\{\1\}/g;
print $_ . "\n";
}elsif(/^\*/){
s/^\* *(.*?)$/\\section\{\1\} /g;
print $_ . "\n";
}
#目次
elsif(/^\#contents/){
print "\\end\{abstract\}\n";
s/^\#contents/\\tableofcontents/;
print $_ . "\n";
print "\\cleardoublepage\n";
print "\\setcounter\{page\}\{1\}\n";
print "\\pagenumbering\{arabic\}\n";
}
#ページ参照
elsif(/》》(.*)《《/){
s/》》(.*?)《《/\\pageref\{\1\}/g;
print $_;
}
#コメント
elsif(/\\\\/){
s/\\\\/\%/;
print $_;
}
#中央寄せ
elsif(/CENTER: *(.*)/){
s/CENTER: *(.*)$/\\begin\{center\}\n \1\n\\end\{center\}\n/;
print $_;
}
#左
elsif(/LEFT: *(.*)/){
s/LEFT: *(.*)$/\\begin\{flushleft\}\n \1\n\\end\{flushleft\}\n/;
print $_;
}
#右
elsif(/RIGHT: *(.*)/){
s/RIGHT: *(.*)$/\\begin\{flushright\}\n \1\n\\end\{flushright
\}\n/;
print $_;
}
elsif($_ eq ""){
print "\n";
}
else{
print $_ . "\n";
}
}
print "\\end\{document\}\n";
>>>