2.0 KiB
LaTeX-to-PDF Conversion Service
This service provides an API endpoint to convert LaTeX documents into PDF format. It supports .zip file uploads containing the LaTeX source file (main.tex) and any associated files (e.g., images or additional .tex files).
Getting Started
Building the Docker Image
To build the Docker image for the conversion service, navigate to the project directory and run:
docker build -t rbehzadan/tex2pdf .
Running the Service
After building the image, you can start the service with the following command:
docker run -d -p 8000:8000 rbehzadan/tex2pdf
This command runs the Docker container in the background (-d) and maps port 8000 of the container to port 8000 on the host, making the service accessible at http://localhost:8000.
API Endpoint
The service exposes a single POST endpoint at /tex2pdf for converting LaTeX to PDF.
Uploading a .zip File
The .zip file should contain a main.tex file and can include additional resources such as images or other .tex files used by main.tex.
Manual Testing
Testing with curl
To test the conversion service with curl, use the following command:
curl -X POST -F "zip_file=@path/to/your/file.zip" http://localhost:8000/tex2pdf -o output.pdf
Replace path/to/your/file.zip with the actual path to your .zip file. The resulting PDF will be saved as output.pdf in the current directory.
Testing with HTTPie
HTTPie offers a more user-friendly way to test the service. Use the following command for testing:
http -f POST http://localhost:8000/tex2pdf zip_file@path/to/your/file.zip > output.pdf
As with curl, replace path/to/your/file.zip with the path to your .zip file. The output will be redirected to output.pdf in the current directory.
Troubleshooting
If you encounter any issues with the conversion process, ensure that your .zip file is structured correctly, with a main.tex file at the root. For more detailed error information, consult the service logs.