doc_pyramid 0.1.2

# doc_pyramid

```rust
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)
}
```

## About

This project is an open-source component of [i18n.site ⋅ Internationalization Solution](https://i18n.site).

* [i18 : MarkDown Command Line Translation Tool](https://i18n.site/i18)

  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](https://i18n.site/i18n.site)

  Optimized for a better reading experience

## 关于

本项目为 [i18n.site ⋅ 国际化解决方案](https://i18n.site) 的开源组件。

* [i18 :  MarkDown命令行翻译工具](https://i18n.site/i18)

  翻译能够完美保持 Markdown 的格式。能识别文件的修改，仅翻译有变动的文件。

  Markdown 翻译内容可编辑；如果你修改原文并再次机器翻译，手动修改过的翻译不会被覆盖（如果这段原文没有被修改）。

* [i18n.site : MarkDown多语言静态站点生成器](https://i18n.site/i18n.site) 为阅读体验而优化。