Skip to content

Commit 9790aba

Browse files
authored
Merge pull request #121 from tp2750/non-std_docslink
Enable non-standard docslink
2 parents b5f4990 + 6a4fcb1 commit 9790aba

2 files changed

Lines changed: 14 additions & 8 deletions

File tree

docs/contributing.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -124,7 +124,8 @@ The `PkgInfo` struct has seven fields, and can be defined with kwargs:
124124
* `docslink` (optional, default: `"https://$username.github.io/$pkgname.jl"`)
125125
* URL to the documentation.
126126
* Set `nothing` if the package does not have documentation.
127-
* Note that `$docslink/dev` and `$docslink/stable` will be used in the documentation.
127+
* By default both `$docslink/dev` and `$docslink/stable` will be used in the documentation.
128+
* To get only a single documentation link, set a `docslink` that ends on "/". Then that URL is used as link to the docs (e.g. `docslink="https://eben60.github.io/Mendeleev.jl/"`).
128129
* `codecovlink` (optional, default: `"https://codecov.io/gh/$username/$pkgname.jl"`)
129130
* URL to codecov page.
130131
* Set `nothing` if the repository does not use CodeCov.

docs/utils.jl

Lines changed: 12 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -21,12 +21,12 @@ const PKGINFOS = [
2121
PkgInfo(pkgname="Chain", username="jkrumbiegel", branch="master", docslink=nothing, codecovlink=nothing),
2222
PkgInfo(pkgname="Lazy", username="MikeInnes", branch="master", docslink=nothing, codecovlink=nothing),
2323
PkgInfo(pkgname="Pipe", username="oxinabox", branch="master", docslink=nothing, codecovlink=nothing),
24-
PkgInfo(pkgname="Unitful", username="PainterQubits", branch="master"),
24+
PkgInfo(pkgname="Unitful", username="JuliaPhysics", branch="master"),
2525
PkgInfo(pkgname="DynamicQuantities", username="SymbolicML", codecovlink=nothing),
2626
PkgInfo(pkgname="UnitSystems", username="chakravala", branch="master", docslink=nothing),
27-
PkgInfo(pkgname="Genie", username="GenieFramework", branch="master", codecovlink=nothing),
27+
PkgInfo(pkgname="Genie", username="GenieFramework", branch="master", codecovlink=nothing, docslink="https://GenieFramework.github.io/Genie.jl/dev/"),
2828
PkgInfo(pkgname="Oxygen", username="OxygenFramework", branch="master"),
29-
PkgInfo(pkgname="Bonito", username="SimonDanisch", branch="master"),
29+
PkgInfo(pkgname="Bonito", username="SimonDanisch", branch="master", docslink="https://SimonDanisch.github.io/Bonito.jl/stable/"),
3030
PkgInfo(pkgname="Mongoose", username="AbrJA", branch="main", docslink="https://abrja.github.io/Mongoose.jl/dev/"),
3131
PkgInfo(pkgname="Plots", username="JuliaPlots", branch="master", docslink="https://docs.juliaplots.org/", codecovlink=nothing),
3232
PkgInfo(pkgname="Makie", username="MakieOrg", branch="master", docslink="https://docs.makie.org/", codecovlink=nothing),
@@ -73,7 +73,7 @@ const PKGINFOS = [
7373
PkgInfo(pkgname="TetGen", username="JuliaGeometry", branch="master"),
7474
PkgInfo(pkgname="GMT", username="GenericMappingTools", branch="master"),
7575
PkgInfo(pkgname="PkgTemplates", username="JuliaCI", branch="master"),
76-
PkgInfo(pkgname="PkgSkeleton", username="tpapp", branch="master"),
76+
PkgInfo(pkgname="PkgSkeleton", username="tpapp", branch="master", docslink=nothing),
7777
PkgInfo(pkgname="Pkg", username="JuliaLang", branch="master"),
7878
PkgInfo(pkgname="PyCall", username="JuliaPy", branch="master"),
7979
PkgInfo(pkgname="PythonCall", username="JuliaPy"),
@@ -174,9 +174,14 @@ function hfun_badge(args)
174174
codecovlink = pkginfo.codecovlink
175175
registered = pkginfo.registered
176176

177-
html_docs = isnothing(docslink) ? "" : """
178-
<a href="$docslink/stable"><img src="https://img.shields.io/badge/docs-stable-blue.svg" alt="Stable"></a>
179-
<a href="$docslink/dev"><img src="https://img.shields.io/badge/docs-dev-blue.svg" alt="Dev"></a>
177+
docreg = r".*/([^/]+)/$"
178+
isnothing(docslink) || (docmatch = match(docreg, docslink))
179+
html_docs = isnothing(docslink) ? "" :
180+
isnothing(docmatch) ? """
181+
<a href="$docslink/stable"><img src="https://img.shields.io/badge/docs-stable-blue.svg" alt="Stable"></a>
182+
<a href="$docslink/dev"><img src="https://img.shields.io/badge/docs-dev-blue.svg" alt="Dev"></a>
183+
""" : """
184+
<a href="$docslink"><img src="https://img.shields.io/badge/docs-$(docmatch[1])-blue.svg" alt="Doc"></a>
180185
"""
181186
html_codecov = isnothing(codecovlink) ? "" : """
182187
<a href="$codecovlink"><img src="$codecovlink/branch/$branch/graph/badge.svg" alt="Coverage"></a>

0 commit comments

Comments
 (0)