aboutsummaryrefslogtreecommitdiff
path: root/src/convert.rs
diff options
context:
space:
mode:
Diffstat (limited to 'src/convert.rs')
-rw-r--r--src/convert.rs68
1 files changed, 68 insertions, 0 deletions
diff --git a/src/convert.rs b/src/convert.rs
new file mode 100644
index 0000000..6661d4f
--- /dev/null
+++ b/src/convert.rs
@@ -0,0 +1,68 @@
+// This file is part of Germ <https://github.com/gemrest/germ>.
+// Copyright (C) 2022-2022 Fuwn <[email protected]>
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, version 3.
+//
+// This program is distributed in the hope that it will be useful, but
+// WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+// General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with this program. If not, see <http://www.gnu.org/licenses/>.
+//
+// Copyright (C) 2022-2022 Fuwn <[email protected]>
+// SPDX-License-Identifier: GPL-3.0-only
+
+//! Convert Gemtext into many types of markup.
+
+mod html;
+mod markdown;
+
+/// Different targets to convert Gemtext to
+pub enum Target {
+ /// Convert Gemtext to HTML
+ HTML,
+ /// Convert Gemtext to Markdown
+ Markdown,
+}
+
+/// Convert AST'd Gemtext into an alternative markup format.
+///
+/// # Example
+///
+/// ```rust
+/// use germ::convert;
+///
+/// convert::convert_from_ast(
+/// germ::ast::build(r#"=> gemini://gem.rest/ GemRest"#),
+/// convert::Target::HTML,
+/// );
+/// ```
+pub fn convert_from_ast(
+ source: Vec<crate::ast::Node>,
+ target: Target,
+) -> String {
+ match target {
+ Target::Markdown => markdown::convert(source),
+ Target::HTML => html::convert(source),
+ }
+}
+
+/// Convert raw Gemtext into an alternative markup format.
+///
+/// # Example
+///
+/// ```rust
+/// use germ::convert;
+///
+/// convert::convert_from_string(
+/// r#"=> gemini://gem.rest/ GemRest"#,
+/// convert::Target::HTML,
+/// );
+/// ```
+pub fn convert_from_string(source: &str, target: Target) -> String {
+ convert_from_ast(crate::ast::build(source), target)
+}