phoenix-oss/llama-stack-mirror
0
0
Fork 1
mirror of https://github.com/meta-llama/llama-stack.git synced 2025-06-28 19:04:19 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

fix: Readthedocs cannot parse comments, resulting in docs bugs (#1033)

Browse source
This commit is contained in:
Ellis Tarn 2025-02-10 13:35:16 -08:00 • committed by GitHub
parent ab9516c789
commit afca9d92f9
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
10 changed files with 18 additions and 11 deletions
Download patch file Download diff file Expand all files Collapse all files

2
docs/source/distributions/self_hosted_distro/dell.md
View file

@ -1,7 +1,7 @@
<!-- This file was auto-generated by distro_codegen.py, please edit source -->
--- ---
orphan: true orphan: true
--- ---
<!-- This file was auto-generated by distro_codegen.py, please edit source -->
# Dell Distribution of Llama Stack # Dell Distribution of Llama Stack

2
docs/source/distributions/self_hosted_distro/fireworks.md
View file

@ -1,7 +1,7 @@
<!-- This file was auto-generated by distro_codegen.py, please edit source -->
--- ---
orphan: true orphan: true
--- ---
<!-- This file was auto-generated by distro_codegen.py, please edit source -->
# Fireworks Distribution # Fireworks Distribution
```{toctree} ```{toctree}

2
docs/source/distributions/self_hosted_distro/meta-reference-gpu.md
View file

@ -1,7 +1,7 @@
<!-- This file was auto-generated by distro_codegen.py, please edit source -->
--- ---
orphan: true orphan: true
--- ---
<!-- This file was auto-generated by distro_codegen.py, please edit source -->
# Meta Reference Distribution # Meta Reference Distribution
```{toctree} ```{toctree}

2
docs/source/distributions/self_hosted_distro/meta-reference-quantized-gpu.md
View file

@ -1,7 +1,7 @@
<!-- This file was auto-generated by distro_codegen.py, please edit source -->
--- ---
orphan: true orphan: true
--- ---
<!-- This file was auto-generated by distro_codegen.py, please edit source -->
# Meta Reference Quantized Distribution # Meta Reference Quantized Distribution
```{toctree} ```{toctree}

2
docs/source/distributions/self_hosted_distro/ollama.md
View file

@ -1,7 +1,7 @@
<!-- This file was auto-generated by distro_codegen.py, please edit source -->
--- ---
orphan: true orphan: true
--- ---
<!-- This file was auto-generated by distro_codegen.py, please edit source -->
# Ollama Distribution # Ollama Distribution
```{toctree} ```{toctree}

2
docs/source/distributions/self_hosted_distro/remote-vllm.md
View file

@ -1,7 +1,7 @@
<!-- This file was auto-generated by distro_codegen.py, please edit source -->
--- ---
orphan: true orphan: true
--- ---
<!-- This file was auto-generated by distro_codegen.py, please edit source -->
# Remote vLLM Distribution # Remote vLLM Distribution
```{toctree} ```{toctree}
:maxdepth: 2 :maxdepth: 2

2
docs/source/distributions/self_hosted_distro/sambanova.md
View file

@ -1,7 +1,7 @@
<!-- This file was auto-generated by distro_codegen.py, please edit source -->
--- ---
orphan: true orphan: true
--- ---
<!-- This file was auto-generated by distro_codegen.py, please edit source -->
# SambaNova Distribution # SambaNova Distribution
```{toctree} ```{toctree}

2
docs/source/distributions/self_hosted_distro/tgi.md
View file

@ -1,7 +1,7 @@
<!-- This file was auto-generated by distro_codegen.py, please edit source -->
--- ---
orphan: true orphan: true
--- ---
<!-- This file was auto-generated by distro_codegen.py, please edit source -->
# TGI Distribution # TGI Distribution

2
docs/source/distributions/self_hosted_distro/together.md
View file

@ -1,7 +1,7 @@
<!-- This file was auto-generated by distro_codegen.py, please edit source -->
--- ---
orphan: true orphan: true
--- ---
<!-- This file was auto-generated by distro_codegen.py, please edit source -->
# Together Distribution # Together Distribution
```{toctree} ```{toctree}

11
llama_stack/templates/template.py
View file

@ -131,8 +131,15 @@ class DistributionTemplate(BaseModel):
providers_str = ", ".join(f"`{p}`" for p in providers) providers_str = ", ".join(f"`{p}`" for p in providers)
providers_table += f"| {api} | {providers_str} |\n" providers_table += f"| {api} | {providers_str} |\n"
template = "<!-- This file was auto-generated by distro_codegen.py, please edit source -->\n" template = self.template_path.read_text()
template += self.template_path.read_text() comment = "<!-- This file was auto-generated by distro_codegen.py, please edit source -->\n"
orphantext = "---\norphan: true\n---\n"
if template.startswith(orphantext):
template = template.replace(orphantext, orphantext + comment)
else:
template = comment + template
# Render template with rich-generated table # Render template with rich-generated table
env = jinja2.Environment( env = jinja2.Environment(
trim_blocks=True, trim_blocks=True,