easy-docx-template

Crates.ioeasy-docx-template
lib.rseasy-docx-template
version0.1.1
created_at2025-09-21 21:57:27.682103+00
updated_at2025-09-22 15:19:16.04628+00
descriptioncreate docx template
homepagehttps://github.com/AltDemono/easy-docx-template-rs
repositoryhttps://github.com/AltDemono/easy-docx-template-rs
max_upload_size
id1849240
size28,438
Dmitriy (AltDemono)

documentation

README

🚀Easy Docx Template

Create docx templates

Usage/Examples

Example 1:

fn main()  {
    // 1. Loading docx file
    let mut docx = DOCX::new("example/test.docx".to_string());
    docx.read();

    // 2. Adding placeholders
    docx.add_placeholder("{{exam.title}}", "Mathexam");
    docx.add_placeholder("{{exam.variant}}", "1 variant");
    docx.add_placeholder("{{exam.subject}}", "Math");
    docx.add_placeholder("{{exam.level}}", "1-A form");

    // 3. Init placeholders
    docx.init_placeholders();

    // 4. Save our docx file
    docx.save("output.docx");
    println!("✅ File saved: output.docx")
}

Example 2(Loading data from json):

fn main() {
    // 1. Loading docx file
    let mut docx = DOCX::new("example/test.docx".to_string());
    docx.read();

    // 2. Adding placeholders
    docx.add_placeholders_from_json(r#"{
       "exam": {
             "level": "form 2-A",
             "variant": "1 variant",
             "title": "Math exam",
             "subject": "math"
           }
        }"#);

    // 3. Init placeholders
    docx.init_placeholders();

    // 4. Save our docx file
    docx.save("output.docx");
    println!("✅ File saved: output.docx")
}

Warning! Image placeholders are initialized when the final file is saved.

Example 3(Add image placeholder)

fn test_1() {
        // 1. Loading docx file
        let mut docx = DOCX::new("example/test.docx".to_string());
        docx.read();

        // 2. Adding placeholders
        docx.add_placeholders_from_json(r#"{
        "exam": {
                "level": "form 2-A",
                "variant": "1 variant",
                "title": "Math exam",
                "subject": "math"
            }
        }"#);
        
        // 4. Add image placeholder
        docx.add_image_placeholder("image1.jpeg", "example/replace_image1.png");

        // 5. Init placeholders
        docx.init_placeholders();

        // 6. Save our docx file
        docx.save("output.docx");
        println!("✅ File saved: output.docx")
    }

example1

Roadmap

  • Add block constructions
  • optimize
  • Add list and table support

🔗Author

Created by Dmitry Dzhugov morfyalt@proton.me

Commit count: 10

cargo fmt