Crates.io | doc_pyramid |
lib.rs | doc_pyramid |
version | 0.1.2 |
created_at | 2025-07-03 08:50:01.246089+00 |
updated_at | 2025-07-03 09:02:17.958949+00 |
description | doc_pyramid |
homepage | https://github.com/i18n-site/rust/tree/dev/doc_pyramid |
repository | https://github.com/i18n-site/rust.git |
max_upload_size | |
id | 1736025 |
size | 25,656 |
use std::future::Future;
use aok::Result;
use doc_chunk::DocChunk;
use futures::{StreamExt, TryStreamExt, stream};
pub async fn digest<AsyncString: Future<Output = Result<String>>>(
txt: &str,
doc_chunk: DocChunk,
short: &impl Fn(String) -> AsyncString,
) -> Result<String> {
let li = stream::iter(doc_chunk.parse(txt))
.map(|i| short(i))
.buffered(16)
.try_collect::<Vec<String>>()
.await?;
Ok(li.join("\n"))
}
pub async fn parse<AsyncString: Future<Output = Result<String>>>(
txt: impl AsRef<str>,
limit: usize,
short: impl Fn(String) -> AsyncString,
) -> Result<Vec<String>> {
let mut txt = txt.as_ref();
let mut result = vec![];
let doc_chunk = DocChunk::new(limit);
while !txt.is_empty() {
let brief = digest(txt, doc_chunk, &short).await?;
let stop = brief.len() <= limit;
result.push(brief);
if stop {
break;
} else {
txt = result.last().unwrap().as_str();
}
}
Ok(result)
}
This project is an open-source component of i18n.site ⋅ Internationalization Solution.
i18 : MarkDown Command Line Translation Tool
The translation perfectly maintains the Markdown format.
It recognizes file changes and only translates the modified files.
The translated Markdown content is editable; if you modify the original text and translate it again, manually edited translations will not be overwritten (as long as the original text has not been changed).
i18n.site : MarkDown Multi-language Static Site Generator
Optimized for a better reading experience
本项目为 i18n.site ⋅ 国际化解决方案 的开源组件。
翻译能够完美保持 Markdown 的格式。能识别文件的修改,仅翻译有变动的文件。
Markdown 翻译内容可编辑;如果你修改原文并再次机器翻译,手动修改过的翻译不会被覆盖(如果这段原文没有被修改)。
i18n.site : MarkDown多语言静态站点生成器 为阅读体验而优化。