WordTemplateProcessor/README.md

# WordTemplateProcessor

This repository provides scripts for processing Word templates (.dotx) by searching and replacing specific text within headers, footers, or the main text body. It includes a setup script to ensure all necessary Python packages are installed.

## Files

- **setup_environment.py**: This script checks if `pip` is installed, installs it if necessary, and then installs the required Python packages.
- **dotx_processor.py**: This script processes `.dotx` files in a specified directory, replacing specified text in headers, footers, or the main text.

## Requirements

- Python 3.x
- Microsoft Word installed
- Internet connection to install packages

## Usage

1. **Setup the Environment:**

   Run the `setup_environment.py` script to ensure `pip` and required packages are installed:
    ```bash
    py setup_environment.py
```
2. **Run the Processor Script:**

   Execute the `dotx_processor.py` script to process Word templates:

```bash
    py dotx_processor.py
    ```
3. **Follow the Prompts:**

The script will prompt you for the following inputs:
- **Path to the input directory**: Enter the path where your `.dotx` files are located.
- **Path to the output directory**: Enter the path where you want the modified files to be saved.
- **Area for text replacement**: Choose where to replace the text (`Header`, `Footer`, or `Text`).
- **Text to find**: Enter the exact text string you want to search for in the documents.
- **Text to replace with**: Enter the new text string that will replace the found text.

## Example Usage

1. Run the setup script to ensure the environment is prepared:

    py setup_environment.py

This command will install `pip` if it is not already installed and then use it to install the necessary Python packages (`pywin32`).

2. Run the processing script to start modifying your `.dotx` files:

    py dotx_processor.py

After running this command, follow the on-screen prompts to specify the directories and text replacement details.

## Notes

- Ensure that Word documents are not open in other applications while running the script to avoid file access issues.
- The output directory must have write permissions for the modified files to be saved correctly.
- Use absolute paths for the input and output directories to avoid path resolution issues.

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.