Qtの基礎 - Markdown - 版の履歴

Wiki: 文字列「FORCETOC」を「{{#seo: |title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki |keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,Podman,電気回路,電子回路,基板,プリント基板 |description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This pag…

2024-10-14T01:58:24Z

文字列「__FORCETOC__」を「{{#seo: |title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki |keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,Podman,電気回路,電子回路,基板,プリント基板 |description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This pag…

← 古い版		2024年10月14日 (月) 10:58時点における版
1,054行目:		1,054行目:
	<br><br>		<br><br>


			{{#seo:
			\|title={{PAGENAME}} : Exploring Electronics and SUSE Linux \| MochiuWiki
			\|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,Podman,電気回路,電子回路,基板,プリント基板
			\|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 \| This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
			\|image=/resources/assets/MochiuLogo_Single_Blue.png
			}}

	__FORCETOC__		__FORCETOC__
	[[カテゴリ:Qt]]		[[カテゴリ:Qt]]

Wiki: /* Hoedownライブラリ */

2024-08-27T16:51:32Z

Hoedownライブラリ

@@ 865行目: / 865行目: @@
 == Hoedownライブラリ ==
 ==== Hoedownライブラリとは ====
+Hoedownライブラリは、高速で柔軟性のあるMarkdown処理のためのC言語ベースのライブラリである。<br>
 <br>
 ==== Hoedownライブラリのライセンス ====
 <br>
 ==== Hoedownライブラリのインストール ====
+[https://github.com/hoedown/hoedown HoedownライブラリのGithub]にアクセスして、ソースコードをダウンロードする。<br>
 <br>
 ==== QtプロジェクトファイルおよびCMakeLists.txtファイル ====

Wiki: /* その他のMarkdownパーサライブラリ */

2024-08-27T16:37:20Z

その他のMarkdownパーサライブラリ

差分を表示

Wiki: /* HTMLファイルへ変換 */

2024-08-27T16:14:03Z

HTMLファイルへ変換

← 古い版		2024年8月28日 (水) 01:14時点における版
803行目:		803行目:
	<br>		<br>

	==== ~~HTMLファイルへ変換~~ ====		==== HTMLからMarkdownへ変換 ====
	以下の例では、cmark-gfmライブラリを使用して、HTMLファイルからMarkdownファイルへ変換している。<br>		以下の例では、cmark-gfmライブラリを使用して、HTMLファイルからMarkdownファイルへ変換している。<br>
	<syntaxhighlight lang="c++">		<syntaxhighlight lang="c++">

Wiki: /* HTMLファイルへ変換 */

2024-08-27T15:53:04Z

HTMLファイルへ変換

差分を表示

Wiki: /* Markdownの解析および操作 2 */

2024-08-27T15:39:30Z

Markdownの解析および操作 2

@@ 502行目: / 502行目: @@
      return a.exec();
+  }
   </syntaxhighlight>

Wiki: /* ソースコードからインストール */

2024-08-27T15:26:26Z

ソースコードからインストール

差分を表示

Wiki: /* Markdownファイルの読み込み */

2024-08-27T14:56:49Z

Markdownファイルの読み込み

← 古い版		2024年8月27日 (火) 23:56時点における版
61行目:		61行目:
	}		}
	</syntaxhighlight>		</syntaxhighlight>
	<br<<br>		<br><br>

	== Markdownファイルの書き込み ==		== Markdownファイルの書き込み ==

Wiki: /* HTMLファイルへ変換 */

2024-08-27T14:56:31Z

HTMLファイルへ変換

← 古い版		2024年8月27日 (火) 23:56時点における版
323行目:		323行目:
	以下の例では、cmark-gfmライブラリを使用して、MarkdownファイルからHTMLファイルへ変換している。<br>		以下の例では、cmark-gfmライブラリを使用して、MarkdownファイルからHTMLファイルへ変換している。<br>
	<syntaxhighlight lang="c++">		<syntaxhighlight lang="c++">
	#include <~~QcoreApplication~~>		#include <QCoreApplication>
	#include <QFile>		#include <QFile>
	#include <QTextStream>		#include <QTextStream>
376行目:		376行目:
	</syntaxhighlight>		</syntaxhighlight>
	<br>		<br>

	==== HTMLファイルへ変換 ====		==== HTMLファイルへ変換 ====
	以下の例では、cmark-gfmライブラリを使用して、HTMLファイルからMarkdownファイルへ変換している。<br>		以下の例では、cmark-gfmライブラリを使用して、HTMLファイルからMarkdownファイルへ変換している。<br>

Wiki: /* HTMLファイルへ変換 */

2024-08-27T14:55:58Z

HTMLファイルへ変換

@@ 434行目: / 434行目: @@
+  }
   </syntaxhighlight>
 <br><br>

Wiki: /* cmark-gfmライブラリ */

2024-08-27T13:45:13Z

cmark-gfmライブラリ

@@ 171行目: / 171行目: @@
   </syntaxhighlight>
 <br><br>
 == cmark-gfmライブラリ ==

Wiki: /* cmark-gfmライブラリ */

2024-08-27T13:26:25Z

cmark-gfmライブラリ

@@ 174行目: / 174行目: @@
 == cmark-gfmライブラリ ==
 ==== cmark-gfmライブラリとは ====
-cmark-gfmライブラリは、GitHub Flavored Markdown (GFM) の解析と変換のためのライブラリである。<br>
+cmark-gfmライブラリは、CommonMarkのC言語リファレンス実装の拡張版であり、GitHub Flavored Markdown (GFM) の解析と変換のためのライブラリである。<br>
 Webアプリケーション、デスクトップアプリケーション、コマンドラインツール等、様々な場面でMarkdownを扱う時に有用なライブラリである。<br>
 <br>
@@ 230行目: / 230行目: @@
 * コマンドラインツール
 *: ライブラリと共にコマンドラインツールも提供されており、ファイルの変換やデバッグに使用できる。
 <br>
 ==== HTMLファイルへ変換 ====

Wiki: /* 概要 */

2024-08-27T12:33:05Z

概要

@@ 1行目: / 1行目: @@
 == 概要 ==
+Markdownは、軽量のマークアップ言語であり、テキストを簡単にフォーマットするために使用される。<br>
 <br><br>

Wiki: ページの作成:「== 概要 ==

== Markdownファイルの読み込み == 以下の例では、指定されたMarkdownファイルを読み込んでいる。
#include #include #include #include QString readMarkdownFile(const QString& filePath) { QFile file(filePath); if (!file.open(QIODevice::ReadOnly | QIODevice::Text)) { qDebug() << "ファイルを開けませんで…」

2024-08-25T10:51:07Z

ページの作成:「== 概要 == == Markdownファイルの読み込み == 以下の例では、指定されたMarkdownファイルを読み込んでいる。 <syntaxhighlight lang="c++"> #include <QCoreApplication> #include <QFile> #include <QTextStream> #include <QDebug> QString readMarkdownFile(const QString& filePath) { QFile file(filePath); if (!file.open(QIODevice::ReadOnly | QIODevice::Text)) { qDebug() << "ファイルを開けませんで…」

新規ページ

== 概要 ==

 

== Markdownファイルの読み込み ==
以下の例では、指定されたMarkdownファイルを読み込んでいる。 
<syntaxhighlight lang="c++">
#include <QCoreApplication>
#include <QFile>
#include <QTextStream>
#include <QDebug>

QString readMarkdownFile(const QString& filePath)
{
QFile file(filePath);
if (!file.open(QIODevice::ReadOnly | QIODevice::Text)) {
qDebug() << "ファイルを開けませんでした:" << filePath;
return QString();
}
QTextStream in(&file);

return in.readAll();
}

int main(int argc, char *argv[])
{
QCoreApplication a(argc, argv);

QString filePath = "input.md";
QString content = readMarkdownFile(filePath);

if (!content.isEmpty()) {
qDebug() << "ファイルの内容:";
qDebug().noquote() << content;
}
else {
qDebug() << "ファイルの読み込みに失敗しました。";
}

return a.exec();
}
</syntaxhighlight>
<br< 

== Markdownファイルの書き込み ==
以下の例では、指定されたコンテンツをMarkdownファイルを書き込んでいる。 
<syntaxhighlight lang="c++">
#include <QCoreApplication>
#include <QFile>
#include <QTextStream>
#include <QDebug>

bool writeMarkdownFile(const QString& filePath, const QString& content)
{
QFile file(filePath);
if (!file.open(QIODevice::WriteOnly | QIODevice::Text)) {
qDebug() << "ファイルを書き込みエラー: " << filePath;
return false;
}
QTextStream out(&file);
out << content;

return true;
}

int main(int argc, char *argv[])
{
QCoreApplication a(argc, argv);

QString filePath = "output.md";
QString content = "# サンプルマークダウン\n\nこれはテストです。\n";

if (writeMarkdownFile(filePath, content)) {
qDebug() << "ファイルの書き込みに成功";
}
else {
qDebug() << "ファイルの書き込みに失敗";
}

return a.exec();
}
</syntaxhighlight>
 

== Markdownファイルの操作 ==
以下の例では、指定されたコンテンツに対して様々な操作 (ヘッダの追加、ボールドテキストの追加、リンクの追加、ヘッダの抽出) を行っている。 
<syntaxhighlight lang="c++">
#include <QCoreApplication>
#include <QDebug>

QString addHeader(const QString& content, int level, const QString& headerText)
{
QString header = QString("#").repeated(level) + " " + headerText + "\n\n";
return header + content;
}

QString addBoldText(const QString& content, const QString& text)
{
return content + "**" + text + "**\n";
}

QString addLink(const QString& content, const QString& text, const QString& url)
{
return content + "[" + text + "](" + url + ")\n";
}

QStringList extractHeaders(const QString& content)
{
QStringList headers;
QStringList lines = content.split("\n");

for (const QString& line : lines) {
if (line.startsWith("#")) {
headers << line.trimmed();
}
}

return headers;
}

int main(int argc, char *argv[])
{
QCoreApplication a(argc, argv);

QString content = "# 元のヘッダ\n\n元のコンテンツ\n";

// ヘッダの追加
content = addHeader(content, 2, "新しいサブヘッダ");
qDebug() << "ヘッダー追加後:";
qDebug().noquote() << content;

// ボールドテキストの追加
content = addBoldText(content, "重要な情報");
qDebug() << "ボールドテキスト追加後:";
qDebug().noquote() << content;

// リンクの追加
content = addLink(content, "QtのWebサイト", "https://www.qt.io/");
qDebug() << "リンク追加後:";
qDebug().noquote() << content;

// ヘッダの抽出
QStringList headers = extractHeaders(content);
qDebug() << "抽出されたヘッダー:";
for (const QString& header : headers) {
qDebug().noquote() << header;
}

return a.exec();
}
</syntaxhighlight>
 

== cmark-gfmライブラリ ==
==== cmark-gfmライブラリとは ====
cmark-gfmライブラリは、GitHub Flavored Markdown (GFM) の解析と変換のためのライブラリである。 
Webアプリケーション、デスクトップアプリケーション、コマンドラインツール等、様々な場面でMarkdownを扱う時に有用なライブラリである。 
 
ライブラリの機能と特徴を以下に示す。
下記の機能により、cmark-gfmライブラリはMarkdownの解析や変換だけでなく、複雑なドキュメント処理システムの構築にも使用できる。 
 
* マークダウンの解析
*: Markdownテキストを構文解析して、抽象構文木 (AST) を生成する。
*: 標準的なMarkdown構文に加えて、GFM固有の拡張をサポートしている。
*: 
* MarkdownからHTMLへの変換
*: 解析されたMarkdownをHTMLに変換する。
*: 変換時に様々なオプションが指定できる。(例: 安全なHTML出力、ハードブレークの処理方法等)
*: 
* HTMLからマークダウンへの変換
*: HTMLをMarkdownに変換する機能も提供している。
*: 
* AST (抽象構文木) の操作
*: 解析されたMarkdownのASTを直接操作できる。
*: これにより、Markdownの構造を動的に変更したり、カスタム処理を行ったりすることが可能である。
*: 
* GitHub Flavored Markdown (GFM) の拡張機能サポート
** テーブル
** タスクリスト
** 取り消し線
** 自動リンク
** コードブロックの言語指定
*: 
* カスタム拡張の実装
*: ライブラリを拡張して、独自のMarkdown要素や処理を追加できる。
*: 
* マルチスレッドセーフ
*: 並行処理を行うアプリケーションでも安全に使用できる。
*: 
* 様々な出力形式
*: HTML以外にも、XMLやManページ形式等、複数の出力形式をサポートしている。
*: 
* UTF-8サポート
*: Unicode文字を適切に処理する。
*: 
* リンクの参照解決
*: Markdown内のリンク参照を自動的に解決する。
*: 
* 脚注のサポート
*: 脚注の解析と適切な出力をサポートしている。
* サニタイズ機能
*: XSS攻撃を防ぐため、HTMLの安全な出力オプションを提供している。
*: 
* エスケープ処理
*: 特殊文字の適切なエスケープ処理を行う。
*: 
* フェンスドコードブロックの処理
*: コードブロックの言語指定や構文ハイライトの準備をする。
*: 
* コマンドラインツール
*: ライブラリと共にコマンドラインツールも提供されており、ファイルの変換やデバッグに使用できる。
 
==== HTMLファイルへ変換 ====
以下の例では、cmark-gfmライブラリを使用して、MarkdownファイルからHTMLファイルへ変換している。 
<syntaxhighlight lang="c++">
#include <QcoreApplication>
#include <QFile>
#include <QTextStream>
#include <cmark-gfm.h>
#include <QDebug>

QString readMarkdownFile(const QString& fileName)
{
QFile file(fileName);
if (!file.open(QIODevice::ReadOnly | QIODevice::Text)) {
qDebug() << "ファイルのオープンに失敗";
return QString();
}

QTextStream in(&file);
QString content = in.readAll();
file.close();

return content;
}

QString markdownToHtml(const QString& markdown)
{
QByteArray markdownUtf8 = markdown.toUtf8();
char *htmlOutput = cmark_markdown_to_html(markdownUtf8.constData(), markdownUtf8.size(), CMARK_OPT_DEFAULT);
QString html = QString::fromUtf8(htmlOutput);

free(htmlOutput);

return html;
}

int main()
{
QString fileName = "<Markdownファイルのパス>";
QString markdownContent = readMarkdownFile(fileName);

if (markdownContent.isEmpty()) {
qDebug() << "ファイルが存在しないまたは空";
return -1;
}

qDebug() << "Original Markdown content:";
qDebug() << markdownContent;

QString htmlContent = markdownToHtml(markdownContent);
qDebug() << "変換されたHTMLの内容:";
qDebug() << htmlContent;

return 0;
}
</syntaxhighlight>
 
==== HTMLファイルへ変換 ====
以下の例では、cmark-gfmライブラリを使用して、HTMLファイルからMarkdownファイルへ変換している。 
<syntaxhighlight lang="c++">
#include <QCoreApplication>
#include <QFile>
#include <QTextStream>
#include <cmark-gfm.h>
#include <QDebug>

bool writeMarkdownFile(const QString& fileName, const QString& content)
{
QFile file(fileName);
if (!file.open(QIODevice::WriteOnly | QIODevice::Text)) {
qDebug() << "ファイルのオープンに失敗";
return false;
}

QTextStream out(&file);
out << content;
file.close();

return true;
}

QString htmlToMarkdown(const QString& html)
{
QByteArray htmlUtf8 = html.toUtf8();
cmark_node* doc = cmark_parse_document(htmlUtf8.constData(), htmlUtf8.size(), CMARK_OPT_DEFAULT);
char* markdownOutput = cmark_render_commonmark(doc, CMARK_OPT_DEFAULT, 0);
QString markdown = QString::fromUtf8(markdownOutput);

free(markdownOutput);
cmark_node_free(doc);

return markdown;
}

int main()
{
QString fileName = "<HTMLファイルのパス>";
QString htmlContent = "<h1>Hello, World!</h1>This is a bold text and italic text.";

QString markdownContent = htmlToMarkdown(htmlContent);

qDebug() << "変換されたMarkdownの内容:";
qDebug() << markdownContent;

if (writeMarkdownFile(fileName, markdownContent)) {
qDebug() << "Markdownファイルへの変換に成功";
}
else {
qDebug() << "Markdownファイルへの変換に失敗";
return -1;
}

return 0;
}
</syntaxhighlight>
 

__FORCETOC__
[[カテゴリ:Qt]]