Skip to content

Commit 4414e83

Browse files
Martin Ågrengitster
authored andcommitted
gitweb.conf.txt: switch pluses to backticks to help Asciidoctor
This paragraph uses a lot of +pluses+ to render text as monospace. That works fine with AsciiDoc (8.6.10), and almost fine with Asciidoctor (1.5.5), which renders the third of these literally ("+$projname+"). The reason seems to be that Asciidoctor trips on the lone plus a bit earlier, even though it is escaped. Switch +$projname+ to `$projname`, and change the next, similar instance too (+$projname/+), because otherwise, we'd trip on /that one/ instead. If we would stop there, we would now start falling over on the escaped plus ('\+') mentioned earlier, rendering /it/ literally. So change that too... In other words, unescape the lone '+' and change all the pluses that follow it to backticks. AsciiDoc renders this paragraph identically before and after this commit, and Asciidoctor now renders this the same as AsciiDoc. I did try to switch the whole paragraph to using backticks rather than pluses. That worked great with Asciidoctor, but confused AsciiDoc... Let's go with this rather surgical change instead. Signed-off-by: Martin Ågren <[email protected]> Signed-off-by: Junio C Hamano <[email protected]>
1 parent b7e1ba5 commit 4414e83

File tree

1 file changed

+3
-3
lines changed

1 file changed

+3
-3
lines changed

Documentation/gitweb.conf.txt

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -786,9 +786,9 @@ forks::
786786
subdirectories of project root (basename) to be forks of existing
787787
projects. For each project +$projname.git+, projects in the
788788
+$projname/+ directory and its subdirectories will not be
789-
shown in the main projects list. Instead, a \'\+' mark is shown
790-
next to +$projname+, which links to a "forks" view that lists all
791-
the forks (all projects in +$projname/+ subdirectory). Additionally
789+
shown in the main projects list. Instead, a \'+' mark is shown
790+
next to `$projname`, which links to a "forks" view that lists all
791+
the forks (all projects in `$projname/` subdirectory). Additionally
792792
a "forks" view for a project is linked from project summary page.
793793
+
794794
If the project list is taken from a file (+$projects_list+ points to a

0 commit comments

Comments
 (0)