How to generate just a depency graph using xelatex.

[ouboub]

Hi I am on Ubuntu 24.04 (either with tcsh or bash shell) I followed the instructions found in https://leanprover-community.github.io/install/debian.html and https://leanprover-community.github.io/install/project.html

And installed leanprover succesfully I am mainly interested, for the moment, in using blueprint, for my manuscripts, because I want go generate a dependency graph for the proof of theorems, using lemma definition etc. I wish I could use lean for my research, (non linear hyperbolic PDEs), but it seems that Lean, still is not suited for such a task.

So what I have in mind, was for example described in Terence Tao: diagram of papers

Tao mentioned quiver which is nice, but you have to construct most of the graph yourself.

Then there is rdfref But it is a bit buggy, and not that comfortable to use.

So I thought to give blueprint a try, but I run into problem, that I want to report.

Here is what I did

Installation of blueprint

I also followed the instructions How to install blueprint

So in my my_proyect folder which is

~/ALLES/HGs/User/Pub/Preprints/Lean/mathematics_in_lean/my_project/my_project 

After running leanblueprint new I have the folder blueprint with a couple of files (I don't understand why \input is used instead of \subfile which allows to run the content.tex file directly) in any case I just wanted to create a dependency graph

So I have

\documentclass[a4paper]{report}
\usepackage{tikz-cd}
\usepackage{geometry}

\usepackage{expl3}
\usepackage[thms=dfn+lem+prop+thm+cor]{blueprint}
\usepackage{amssymb, amsthm, mathtools}
\usepackage[unicode,colorlinks=true,linkcolor=blue,urlcolor=magenta, citecolor=blue]{hyperref}

\usepackage[warnings-off={mathtools-colon,mathtools-overbracket}]{unicode-math}

\input{macros/common}
\input{macros/print}

\title{Energy estimates}
\author{Uwe Brauer}

\begin{document}
\maketitle
\input{content}
\end{document}

And the content file reads

\begin{theorem}[Smale 1958]
  \label{thm:sphere_eversion}
  \lean{sphere_eversion}
  \leanok
  \uses{def:immersion}
  There is a homotopy of immersions of $𝕊^2$ into $ℝ^3$ from the inclusion map to
  the antipodal map $a : q ↦ -q$.
\end{theorem}

\begin{theorem}[Decaying energy estimate]
  \label{thm:open-ample}
  \lean{sphere_eversion}
  \leanok
  \uses{def:immersion}
  The following estimate holds
\end{theorem}

\begin{proof}
  \leanok
  \uses{thm:open-ample, lem:open_ample_immersion}
  This obviously follows from what we did so far.
\end{proof}

But no graph is generated, what do I miss, or where do I find relevant documentation?

thanks

Uwe Brauer

[utensil]

Option dep_graph is missing from your \usepackage[dep_graph]{blueprint} line.

It should be there if you use the leanblueprint CLI tool to generate your project.

By the way, leanblueprint works perfectly fine without lean. You can use only \label, \uses, and you'll already have your dependency graph. \leanok can be used to mark the state, and it also doesn't involve lean except having lean in its name. If you are not using lean, you don't need to use \lean.

[ouboub]

Option dep_graph is missing from your \usepackage[dep_graph]{blueprint} line.

It should be there if you use the leanblueprint CLI tool to generate your project.

By the way, leanblueprint works perfectly fine without lean. You can use only \label, \uses, and you'll already have your dependency graph. \leanok can be used to mark the state, and it also doesn't involve lean except having lean in its name. If you are not using lean, you don't need to use \lean.

Well it does not work, sorry to say (TL 2004, xelatex) content file reads

\begin{theorem}[Smale 1958]
  \label{thm:sphere_eversion}
  \lean{sphere_eversion}
  \leanok
  \uses{def:immersion}
  There is a homotopy of immersions of $𝕊^2$ into $ℝ^3$ from the inclusion map to
  the antipodal map $a : q ↦ -q$.
\end{theorem}

\begin{theorem}[Decaying energy estimate]
  \label{thm:open-ample}
  \lean{thm:open-ample}
  \leanok
  \uses{def:immersion}
  The following estimate holds
\end{theorem}

\begin{proof}
  \leanok
  \uses{thm:open-ample}
  This obviously follows from what we did so far.
\end{proof}

here is the pdf file print.pdf

[utensil]

Do you have the line like

\usepackage[showmore,dep_graph]{blueprint}

And I guess there is a misunderstanding here, dependency graph is only generated for the web version, see e.g. https://imperialcollegelondon.github.io/FLT/blueprint/dep_graph_chapter_2.html .

However, if you wish to include the same graph in your LaTeX, you can copy the dot code from the source code of the generated html page (right click in the browser and choose view page, then scroll down to almost the bottom), something like:

.renderDot(`strict digraph "" { graph ...lots of stuff .... } `)

  Then you can copy everything between the backtick, and use dot2tex or similar.

It will look like this:

\begin{figure}[H]
    \centering
    {
    \begin{dot2tex}[dot,graphstyle={scale=0.8,transform shape}]
        strict digraph "" { graph ...lots of stuff .... }
    \end{dot2tex}
    }
    \caption{Dependency graph}
    \label{fig:dep_graph}
\end{figure}

[ouboub]

"U" == Utensil @.***> writes:

Do you have the line like

\usepackage[showmore,dep_graph]{blueprint}

No, in your last reply you only mentioned

\usepackage[dep_graph]{blueprint}
``

> And I guess there is a misunderstanding here, dependency graph is only generated for the web version, see e.g.  https://imperialcollegelondon.github.io/FLT/blueprint/dep_graph_chapter_2.html .

Aha, my hope was that it could be used a bit like rdfref, I mentioned in my first message, but appearantly it can't

So if it is not too much to ask, how would I generate the web version (I presume it will only appear on my github repository but not say on a web page running apache on my Laptop)?

> However, if you wish to include the same graph in your LaTeX, you can copy the dot code from the source code of the html page (right click in the browser and choose view page, then scroll down to almost the bottom), something like:

> ```
> .renderDot(`strict digraph "" {   graph ...lots of stuff .... } `)
> ```
>  
> Then you can copy everything between the backtick, and use [dot2tex](https://dot2tex.readthedocs.io/en/latest/) or similar.

Ok dot2tex is what rdfref uses as well.

> It will look like this:

> ```
> \begin{figure}[H]
>     \centering
>     {
>     \begin{dot2tex}[dot,graphstyle={scale=0.8,transform shape}]
>         strict digraph "" {   graph ...lots of stuff .... }
>     \end{dot2tex}
>     }
>     \caption{Dependency graph}
>     \label{fig:dep_graph}
> \end{figure}
> ```

-- 
I strongly condemn Hamas heinous despicable pogroms/atrocities on Israel
I strongly condemn Putin's war of aggression against Ukraine.
I support to deliver weapons to Ukraine's military. 
I support the EU and NATO membership of Ukraine. 

[utensil]

showmore is not required, I just didn't delete all my options.

The webpage is generated and pushed to your Github Pages by Github Actions workflows, as documented in README.

To see them on your own laptop, you don't need apache, just leanblueprint serve which is also mentioned in README.

[ouboub]

leanblueprint serve returned an error of a missing web directory. So I thought, I start again from scratch and I encountered some errors I can't remember to have seen before:

• I need lean installed, because running leanblueprint new leads to an error:

Error: Could not find a Lean project. Please run this command from inside your project folder.

• I then created a new empty public git repository, and enabled git actions in the pages section (but did not specify any action)

• then i run leanblueprint new within my leanproject folder when asked about the url of the github repository I insert my new empty github repository , the same for the website project and for the docs... I use the minimal Jekyell them, Now I receive

  
  Git commit created. Don't forget to push when you are ready.

You are all set 🎉

but 
`git remote -v`
returns

origin https://github.com/leanprover-community/mathematics_in_lean.git (fetch) origin https://github.com/leanprover-community/mathematics_in_lean.git (push)

Ah, what? I don't want and should not push to his repository, 
what do I miss  here?

[ouboub]

Indeed my first goal is to generate a graph similar to chapter 2 Fermat locally using

• leanbluprint web
• leanbluprint server
• and display it via my browser

So I tried out the exact example of leanbluprint github namely

\begin{theorem}[Smale 1958]
  \label{thm:sphere_eversion}
  \lean{sphere_eversion}
  \leanok
  \uses{def:immersion}
  There is a homotopy of immersions of $𝕊^2$ into $ℝ^3$ from the inclusion map to
  the antipodal map $a : q ↦ -q$.
\end{theorem}

\begin{proof}
  \leanok
  \uses{thm:open_ample, lem:open_ample_immersion}
  This obviously follows from what we did so far.
\end{proof}

and copy this into content.tex then running

• leanbluprint web
• leanbluprint server
• and display it via my browser

Leads to the following display, which I attach,

but which is not similar to the graph found in chapter 2 Fermat

What do I miss?

Uwe Brauer

[utensil]

Your screenshot isn't complete, on the left panel there should be a chapter with name like dependency graph, and that's where the dep graph is.

[ouboub]

Your screenshot isn't complete, on the left panel there should be a chapter with name like dependency graph, and that's where the dep graph is.

attached you find the complete screenshot, there is no left panel (using the latest chrome browser) (chrome displayed the Fermat example correctly!)

[utensil]

It's hard to tell which step went wrong without looking at your code. By only descriptions of what you have been piecing things together, I can only make guesses, that's a long shot.

Instead, I would suggest to clone one of the example repos listed in the README, make them work locally, then reduce to what you need.

[ouboub]

ok, that makes sense, shall I clone it into

~/ALLES/HGs/User/Pub/Preprints/Lean/mathematics_in_lean/my_project 

?

[utensil]

Anywhere that doesn't affect your exsiting files should be fine.

[ouboub]

ok, I did, that was helpful thanks