Skip to content

Commit dfb48dc

Browse files
committed
Revert "[lldb/infra] Revamp lldb.llvm.org"
This patch reverts the lldb website revamp (eea8874) since the `furo` theme that we use is not installed on the publisher bot. The prevents other website from getting there documentation updated. Signed-off-by: Med Ismail Bennani <[email protected]>
1 parent 205c804 commit dfb48dc

20 files changed

+1964
-1324
lines changed

lldb/docs/_static/lldb.css

Lines changed: 100 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,100 @@
1+
pre {
2+
padding: 7px;
3+
}
4+
5+
div.document {
6+
width: 90%;
7+
}
8+
9+
div.body {
10+
max-width: 90%;
11+
}
12+
13+
div.note {
14+
padding: 20px 20px 10px 20px;
15+
}
16+
17+
div.note p.admonition-title {
18+
font-size: 130%;
19+
}
20+
21+
table.mapping {
22+
width: 100%;
23+
}
24+
25+
table.mapping td {
26+
width: 50%;
27+
padding: 5px;
28+
}
29+
30+
table.mapping td.hed {
31+
background: #606060;
32+
color: #fefefe;
33+
text-align: left;
34+
border-bottom: 2px #fefefe solid;
35+
font-weight: bold;
36+
}
37+
38+
table.mapping td.header {
39+
background: #eeeeee;
40+
}
41+
42+
table.mapping td.content {
43+
font-family: monospace;
44+
padding-bottom: 15px;
45+
}
46+
47+
/* Workaround for a Safari bug that would otherwise make table cells less wide
48+
than the containing text. This just sets it back to the default browser
49+
property.*/
50+
td {
51+
-webkit-hyphens: manual !important;
52+
}
53+
54+
div.sphinxsidebar .caption {
55+
font-family: Helvetica, Verdana, sans-serif;
56+
font-size: 10pt;
57+
font-weight: bold;
58+
color: #fefefe;
59+
background: #606060;
60+
margin-bottom: 0;
61+
text-transform: uppercase;
62+
padding: 7px;
63+
}
64+
65+
div.sphinxsidebar a,
66+
div.sphinxsidebar a:hover {
67+
border: none;
68+
}
69+
70+
div.sphinxsidebar li {
71+
padding-left: 7px;
72+
border-bottom: 1px solid #fefefe;
73+
}
74+
75+
div.sphinxsidebar li:hover {
76+
background: #eeeeee;
77+
}
78+
79+
div.sphinxsidebar ul {
80+
background: #e9e9e9;
81+
margin: 0px;
82+
padding: 0px;
83+
}
84+
85+
div.sphinxsidebar ul a {
86+
font-family: Helvetica, Verdana, sans-serif;
87+
font-size: 8pt;
88+
display: block;
89+
padding: 5px 0;
90+
line-height: 14pt;
91+
}
92+
93+
div.sphinxsidebar ul li.toctree-l1 > a {
94+
font-size: 100%;
95+
}
96+
97+
div.sphinxsidebar h3 {
98+
/* Hide Navigation. */
99+
display: none;
100+
}

lldb/docs/conf.py

Lines changed: 11 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -57,16 +57,6 @@
5757
)
5858
extensions.append("sphinx_automodapi.automodapi")
5959

60-
try:
61-
import furo
62-
except ModuleNotFoundError:
63-
print(
64-
f"install sphinx furo theme with {sys.executable} -m pip install furo"
65-
)
66-
# The theme to use for HTML and HTML Help pages. See the documentation for
67-
# a list of builtin themes.
68-
html_theme = "furo"
69-
7060
# Add any paths that contain templates here, relative to this directory.
7161
templates_path = ["_templates"]
7262

@@ -141,19 +131,23 @@
141131

142132
# The theme to use for HTML and HTML Help pages. See the documentation for
143133
# a list of builtin themes.
144-
html_theme = "furo"
134+
html_theme = "alabaster"
145135

146136
# Theme options are theme-specific and customize the look and feel of a theme
147137
# further. For a list of options available for each theme, see the
148138
# documentation.
149-
html_theme_options = {}
139+
html_theme_options = {
140+
"font_size": "11pt",
141+
# Don't generate any links to GitHub.
142+
"github_button": "false",
143+
}
150144

151145
# Add any paths that contain custom themes here, relative to this directory.
152146
# html_theme_path = []
153147

154148
# The name for this set of Sphinx documents. If None, it defaults to
155149
# "<project> v<release> documentation".
156-
html_title = "🐛 LLDB"
150+
html_title = "The LLDB Debugger"
157151

158152
# A shorter title for the navigation bar. Default is the same as html_title.
159153
# html_short_title = None
@@ -172,6 +166,10 @@
172166
# so a file named "default.css" will overwrite the builtin "default.css".
173167
html_static_path = ["_static"]
174168

169+
html_context = {
170+
"css_files": ["_static/lldb.css"],
171+
}
172+
175173
html_extra_path = [".htaccess"]
176174

177175
# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,

lldb/docs/resources/build.rst

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,9 @@
11
Building
22
========
33

4+
.. contents::
5+
:local:
6+
47
Getting the Sources
58
-------------------
69

lldb/docs/resources/caveats.rst

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,9 @@
11
Caveats
22
=======
33

4+
.. contents::
5+
:local:
6+
47
.. _python_caveat:
58

69
Python

lldb/docs/resources/overview.rst

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,9 @@ general architecture.
77

88
LLDB has many code groupings that makeup the source base:
99

10+
.. contents::
11+
:local:
12+
1013
API
1114
---
1215

lldb/docs/resources/projects.rst

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,9 @@ Open Projects
44
The following is a mostly unordered set of the ideas for improvements to the
55
LLDB debugger. Some are fairly deep, some would require less effort.
66

7+
.. contents::
8+
:local:
9+
710
Speed up type realization in lldb
811
---------------------------------
912

lldb/docs/resources/test.rst

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,9 @@
11
Testing
22
=======
33

4+
.. contents::
5+
:local:
6+
47
Test Suite Structure
58
--------------------
69

lldb/docs/use/formatting.rst

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,9 @@
11
Frame and Thread Format
22
=======================
33

4+
.. contents::
5+
:local:
6+
47
LLDB has a facility to allow users to define the format of the information that
58
generates the descriptions for threads and stack frames. Typically when your
69
program stops at a breakpoint you will get two lines that describes why your

lldb/docs/use/intel_pt.rst

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,9 @@
11
Tracing with Intel Processor Trace
22
==================================
33

4+
.. contents::
5+
:local:
6+
47
Intel PT is a technology available in modern Intel CPUs that allows efficient
58
tracing of all the instructions executed by a process.
69
LLDB can collect traces and dump them using its symbolication stack.

0 commit comments

Comments
 (0)