Comments (7)
Oh I see.
I provided a minimum example here. I use platform = "none"
. The full makedocs
call is:
makedocs(remotes = nothing, sitename = "test",
format = Documenter.LaTeX(platform = "none"),
pages = ["Home" => "index.md", "Buggy" => Any["BuggingMe" => "buggy/buggyagain/buggy.md"]],
build = "build-pdf")
Then I manually compile the .tex file using the standard pdflatex
and latexmk
in my Windows PATH.
I did try Docker. There's no problem with the juliadocs/documenter-latex
Docker. But I didn't try Tectonic.
I also tried to not pass the platform
keyword. Then the compilation of the .tex file failed. If I track down the .tex file that Julia produced, I see the \
path separator in image path instead of /
.
from documenter.jl.
PS: I am using Windows. Here's my versioninfo()
:
julia> versioninfo()
Julia Version 1.10.0
Commit 3120989f39 (2023-12-25 18:01 UTC)
Build Info:
Official https://julialang.org/ release
Platform Info:
OS: Windows (x86_64-w64-mingw32)
CPU: 16 × AMD Ryzen 7 5800H with Radeon Graphics
WORD_SIZE: 64
LIBM: libopenlibm
LLVM: libLLVM-15.0.7 (ORCJIT, znver3)
Threads: 1 on 16 virtual cores
Environment:
JULIA_CONDAPKG_BACKEND = Null
JULIA_PKG_SERVER = https://pkg.julialang.org
JULIA_PYTHONCALL_EXE = D:\Programs\mambaforge\envs\torch\python.exe
JULIA_EDITOR = code
JULIA_NUM_THREADS =
from documenter.jl.
Note: replace(image.path, '\\' => '/')
would be a quick fix in most cases.
from documenter.jl.
Yeah, this looks like missing handling of the windows path separator. We do such replacements in other places, so might just be an oversight.
Which platform
are you using though? I am surprised that Windows native TeX wouldn't be able to handle the \
separator?
from documenter.jl.
I am not sure what you mean by platform
? I am using MiKTeX on Windows, if this is the information you want to know.
from documenter.jl.
You can pass the platform
keyword to LaTeX
to switch to e.g. a Docker-based approach or Tectonic. But you're just relying on the standard pdflatex
and latexmk
in your Windows PATH
then I presume?
from documenter.jl.
According to this stackexchange answer, the LaTeX paths should always be /
, so I think we should do the replacements. Would be happy to review a PR -- just need to find the right lines in https://github.com/JuliaDocs/Documenter.jl/blob/master/src/latex/LaTeXWriter.jl
from documenter.jl.
Related Issues (20)
- Feature request: ANSI color output in doctests HOT 6
- Separate jldoctest environments HOT 1
- use of the `Base`-internal function `tuple_type_tail`
- Typing `th` into the Documenter.jl search bar throws a javascript error HOT 1
- invalid scape sequence when trying to run jldoctest with filters as standard test HOT 1
- Document Julia types of function options/kwargs
- Is `docs/instantiate.jl` obsolete? HOT 1
- Documenter not finding dynamic documentation HOT 4
- @eval returning @docs blocks don't render as documentation. HOT 5
- Feature proposal: @include blocks HOT 10
- Console shows error when metadata is not present in certain pages HOT 1
- Inter-Module at-refs? HOT 9
- Warn on (ignored) HTML comments in markdown HOT 1
- make.jl fails with git error
- Can't emit ANSI strings from `@example` block in custom writer HOT 1
- RequireJS prevents integrating SwaggerUI with a user script HOT 1
- Prefer no trailing slash HOT 8
- Unsatisfiable requirements detected for package REPL HOT 11
- Improve the link vs collapse UX in docstring headers HOT 5
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from documenter.jl.