dotnet / dotnet/docfx

[Bug] PlantUml local rendering on Ubuntu: java.exe not found

Open
#10,435 4 comments 0 reactions 0 assignees View on GitHub
Dominant language
C#
Stars
4.4k
Forks
890
Avg merge
2h 11m
Merged PRs (30d)
10

Description

**PlantUML local rendering on Ubuntu: java.exe not found**
When trying to build PlantUML files locally during a docfx build using the plantuml.jar on a linux machine, an error gets thrown:
![Image](https://github.com/user-attachments/assets/32580b2c-f982-4776-b462-28b10073fa7c)

It seems to want to access the java.exe to run the jar.
I tried to run the exact same project on a Windows 10 Machine, where it ran as expected.

**To Reproduce**
Steps to reproduce the behavior:
1. Install DocFx on an Ubuntu Machine and initialize a project
3. Add a plantUml Diagram to your docfx project
4. Install the plantuml.jar and add to project: https://plantuml.com/de/download (I used MIT)
5. Edit docfx.json:
![Image](https://github.com/user-attachments/assets/b65ea794-e23c-438e-9f85-39b3cedba761)
5. Run docfx build

**Expected behavior**
docfx build should run and build the PlantUML Diagrams using the locally installed plantuml.jar.

**Context:**
- OS: Ubuntu 24.04.1 LTS
- Docfx version: 2.78.2
- Java version: openjdk 21.0.5 2024-10-15

**Additional context**
Using the remote server plantuml.com is not possible, due to the machine being offline.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.