Only use :sage_root: for files that exist in the repo

git grep -l 'sage_root.*venv' | xargs sed -E -i.bak 's,:sage_root:`(venv|logs|local),:file:`SAGE_ROOT/\1,g'

Author: Matthias Koeppe

src/doc/de/tutorial/sagetex.rst

@@ -15,7 +15,7 @@ Tutorial und den Abschnitt "Make SageTeX known to TeX" des `Sage installation gu
 Installationsanleitung führen) um weitere Informationen zu erhalten.
 
 Hier stellen wir ein sehr kurzes Beispiel vor wie man SageTeX nutzt.
-Die komplette Dokumentation finden Sie unter :sage_root:`venv/share/texmf/tex/latex/sagetex`,
+Die komplette Dokumentation finden Sie unter :file:`SAGE_ROOT/venv/share/texmf/tex/latex/sagetex`,
 wobei ``SAGE_ROOT`` das Installationsverzeichnis von Sage ist. Dieses Verzeichnis
 enthält die Dokumentation, eine Beispieldatei und einige nützliche Python Skripte.
 
@@ -103,4 +103,4 @@ an den Sage Befehlen in Ihrem Dokument vorgenommen haben.
 
 Es gibt noch viel mehr über SageTeX zu sagen, aber da sowohl Sage alsauch
 LaTeX komplexe und mächtige Werkzeuge sind, sollten Sie die Dokumentation
-über SageTeX in :sage_root:`venv/share/texmf/tex/latex/sagetex` lesen.
+über SageTeX in :file:`SAGE_ROOT/venv/share/texmf/tex/latex/sagetex` lesen.

src/doc/en/tutorial/sagetex.rst

@@ -12,10 +12,10 @@ An example
 ----------
 
 Here is a very brief example of using SageTeX. The full documentation
-can be found in :sage_root:`venv/share/doc/sagetex`,
+can be found in :file:`SAGE_ROOT/venv/share/doc/sagetex`,
 where ``SAGE_ROOT`` is the directory where your Sage installation is
 located. That directory contains the documentation and an example file.
-See :sage_root:`venv/share/texmf/tex/latex/sagetex` for
+See :file:`SAGE_ROOT/venv/share/texmf/tex/latex/sagetex` for
 some possibly useful Python scripts.
 
 To see how SageTeX works, follow the directions for installing SageTeX (in
@@ -105,7 +105,7 @@ commands in your document.
 There's a lot more to SageTeX, and since both Sage and LaTeX are
 complex, powerful tools, it's a good idea to read the documentation for
 SageTeX, which is in
-:sage_root:`venv/share/doc/sagetex`.
+:file:`SAGE_ROOT/venv/share/doc/sagetex`.
 
 .. _sec-sagetex_install:
 
@@ -122,7 +122,7 @@ installation aware of it before it will work.
 
 The key to this is that TeX needs to be able to find ``sagetex.sty``,
 which can be found in
-:sage_root:`venv/share/texmf/tex/latex/sagetex/`, where
+:file:`SAGE_ROOT/venv/share/texmf/tex/latex/sagetex/`, where
 ``SAGE_ROOT`` is the directory where you built or installed Sage. If
 TeX can find ``sagetex.sty``, then SageTeX will work. There are several
 ways to accomplish this.
@@ -169,7 +169,7 @@ ways to accomplish this.
 
   which will print out a directory, such as ``/home/drake/texmf`` or
   ``/Users/drake/Library/texmf``. Copy the ``tex/`` directory from
-  :sage_root:`venv/share/texmf/` into your home ``texmf`` directory
+  :file:`SAGE_ROOT/venv/share/texmf/` into your home ``texmf`` directory
   with a command like
 
   .. CODE-BLOCK:: shell-session
@@ -225,7 +225,7 @@ SageTeX documentation
 
 While not strictly part of installation, it bears mentioning here that
 the documentation for SageTeX is maintained in
-:sage_root:`venv/share/doc/sagetex/sagetex.pdf`. There is also an
+:file:`SAGE_ROOT/venv/share/doc/sagetex/sagetex.pdf`. There is also an
 example file in the same directory -- see ``example.tex`` and
 ``example.pdf``, the pre-built result of typesetting that file with
 LaTeX and Sage. You can also get those files from the `SageTeX page <https://github.com/sagemath/sagetex>`_.

src/doc/ja/tutorial/sagetex.rst

@@ -12,8 +12,8 @@ SageTeXパッケージを使うと，Sageによる処理結果をLaTeX文書に
 =======
 
 ここでは，ごく簡単な例題を通してSageTeXの利用手順を紹介する．
-完全な解説ドキュメントと例題ファイルは，ディレクトリ :sage_root:`venv/share/doc/sagetex` に置いてある．
-:sage_root:`venv/share/texmf/tex/latex/sagetex` にあるPythonスクリプトは何か役に立つ場面があるはずだ．
+完全な解説ドキュメントと例題ファイルは，ディレクトリ :file:`SAGE_ROOT/venv/share/doc/sagetex` に置いてある．
+:file:`SAGE_ROOT/venv/share/texmf/tex/latex/sagetex` にあるPythonスクリプトは何か役に立つ場面があるはずだ．
 以上の ``SAGE_ROOT`` は，Sageをインストールしたディレクトリである．
 
 
@@ -98,7 +98,7 @@ SageTeXの動作を体験するために，まずSageTeXのインストール手
 
 
 SageTeXは到底以上で語り尽せるものでなく，SageとLaTeXは共に複雑で強力なツールだ．
-:sage_root:`venv/share/doc/sagetex` にあるSageTeXのドキュメントを読むことを強くお勧めする．
+:file:`SAGE_ROOT/venv/share/doc/sagetex` にあるSageTeXのドキュメントを読むことを強くお勧めする．
 
 
 .. _sec-sagetex_install:
@@ -118,7 +118,7 @@ SageTeXはデフォルトでSageにインストールされるが，LaTeX文書
 
 鍵になるのは， TeXが ``sagetex.sty`` を発見できるかどうかである．
 この ``sagetex.sty`` は， ``SAGE_ROOT`` をSageがビルトあるいはインストールされたディレクトリとすると，
-:sage_root:`venv/share/texmf/tex/latex/sagetex/` に置かれているはずだ．
+:file:`SAGE_ROOT/venv/share/texmf/tex/latex/sagetex/` に置かれているはずだ．
 TeXが ``sagetex.sty`` を読めるようにしてやらなければ，SageTeXも動作できないのである．
 これを実現するには何通りかのやり方がある．
 
@@ -163,7 +163,7 @@ TeXが ``sagetex.sty`` を読めるようにしてやらなければ，SageTeX
 
       kpsewhich -var-value=TEXMFHOME
 
-  を実行する．すると ``/home/drake/texmf`` や ``/Users/drake/Library/texmf`` などと表示されるはずだから， :sage_root:`venv/share/texmf/` 内の ``tex/`` ディレクトリをホームディレクトリの ``texmf`` にコピーするには
+  を実行する．すると ``/home/drake/texmf`` や ``/Users/drake/Library/texmf`` などと表示されるはずだから， :file:`SAGE_ROOT/venv/share/texmf/` 内の ``tex/`` ディレクトリをホームディレクトリの ``texmf`` にコピーするには
 
   ::
 
@@ -210,7 +210,7 @@ SageTeXドキュメント
 ---------------------
 
 厳密にはSageのインストール一式には含まれないものの，ここで
-SageTeXのドキュメントが :sage_root:`venv/share/doc/sagetex/sagetex.pdf` に配置されていることに触れておきたい．
+SageTeXのドキュメントが :file:`SAGE_ROOT/venv/share/doc/sagetex/sagetex.pdf` に配置されていることに触れておきたい．
 同じディレクトリには例題ファイルと，これをLaTeXとSageTeXによってすでに組版処理した結果も用意されている(``example.tex`` と ``example.pdf`` を参照)．
 これらのファイルは `SageTeX ページ <https://github.com/sagemath/sagetex>`_ からダンロードすることもできる．
 

src/doc/pt/tutorial/sagetex.rst

@@ -14,7 +14,7 @@ instalação do Sage <http://doc.sagemath.org/html/en/installation/index.html>`_
 
 Aqui vai um breve exemplo de como usar o SageTeX. A documentação
 completa pode ser encontrada em
-:sage_root:`venv/share/texmf/tex/latex/sagetex`, onde
+:file:`SAGE_ROOT/venv/share/texmf/tex/latex/sagetex`, onde
 ``SAGE_ROOT`` é o diretório onde se encontra a sua instalação. Esse
 diretório contém a documentação, um arquivo de exemplo, e alguns
 scripts em Python possivelmente úteis.
@@ -107,4 +107,4 @@ os comandos em Sage em seu documento.
 Há muito mais sobre o SageTeX, e como tanto o Sage como o LaTeX são
 ferramentas complexas e poderosas, é uma boa idéia ler a documentação
 para o SageTeX que se encontra em
-:sage_root:`venv/share/texmf/tex/latex/sagetex`.
+:file:`SAGE_ROOT/venv/share/texmf/tex/latex/sagetex`.

src/doc/ru/tutorial/sagetex.rst

@@ -12,7 +12,7 @@ SageTeX known to TeX" `Руководства по установке Sage
 по установке).
 
 В этом уроке показан небольшой пример использования SageTeX. Полная документация
-находится в :sage_root:`venv/share/texmf/tex/latex/sagetex`, где
+находится в :file:`SAGE_ROOT/venv/share/texmf/tex/latex/sagetex`, где
 ``SAGE_ROOT`` - это директория, в которой установлен Sage. Эта папка содержит
 документацию, файл с примером и полезные скрипты Python.
 
@@ -89,4 +89,4 @@ SageTeX known to TeX" `Руководства по установке Sage
 
 SageTeX предлагает много возможностей, и так как Sage и LaTeX являются
 мощными инструментами, то стоит изучить
-:sage_root:`venv/share/texmf/tex/latex/sagetex`.
+:file:`SAGE_ROOT/venv/share/texmf/tex/latex/sagetex`.