update gallery for UnicodePlots

[t-bltg]

Following JuliaPlots/Plots.jl#4149, and JuliaPlots/UnicodePlots.jl#239.

[johnnychen94]

It looks like the new release v1.27.2 does not trigger the documentation rebuild.

[t-bltg]

I have to merge JuliaPlots/UnicodePlots.jl#240 for this PR to work.

[johnnychen94]

Sorry, I meant https://docs.juliaplots.org/stable/ is still targeting v1.27.1 at the moment and I didn't see the docs CI run against v1.27.2 label in https://github.com/JuliaPlots/Plots.jl/actions/workflows/docs.yml. Any ideas?

[t-bltg]

Any ideas?

Oh yes, this is because https://github.com/JuliaPlots/Plots.jl/runs/5665604496?check_suite_focus=true has built the docs for JuliaPlots/Plots.jl@0686461, which was before I bumped the Plots.jl version to 1.27.2 in JuliaPlots/Plots.jl@bcc66ca (which skipped ci and thus building the docs).

So any commit to master will now build the docs for 1.27.2.

I would also like to remove the docs pages for the old versions (1.25, 1.26, ...) (per #270).

[BeastyBlacksmith]

So any commit to master will now build the docs for 1.27.2.

Without tag they only build for dev. You can trigger the build manually on the actions tab (which I did now) or you don't put [skip ci] on the commit message that gets the tag.

[johnnychen94]

I see you need JuliaDocs/DemoCards.jl#109 for debug purposes. How about committing docs/Manifest.toml file with the dev-ed version of that branch via git add -f docs/Manifest.toml? When everything works fine we can safely delete the Manifest file.

For local development, you can first run generate_cards(:unicodeplots) to generate the files, and then use DemoCards.preview_demos("docs/src/gallery/unicodeplots") for fast preview.

[t-bltg]

How about committing docs/Manifest.toml file with the dev-ed version of that branch via git add -f docs/Manifest.toml? When everything works fine we can safely delete the Manifest file.

I don't understand this. I work locally and I don't have any Manifest file here.

For local development

I am sticking with the docs.yml command: JULIA_DEBUG=Documenter,DemoCards GITLAB_CI=true GKSwstype=nul julia --project=docs/ docs/make.jl

[johnnychen94]

(docs) pkg> add https://github.com/t-bltg/DemoCards.jl.git#debug
     Cloning git-repo `https://github.com/t-bltg/DemoCards.jl.git`
    Updating git-repo `https://github.com/t-bltg/DemoCards.jl.git`
    Updating registry at `~/.julia/registries/General.toml`
...

shell> git add docs/Manifest.toml -f

shell> git status
Refresh index: 100% (249/249), done.
On branch master
Your branch is up to date with 'origin/master'.

Changes to be committed:
  (use "git restore --staged <file>..." to unstage)
        new file:   docs/Manifest.toml
...

shell> git commit -m "debug: temporarly commit docs/Manifest.toml"
[master c22be33] debug: temporarly commit docs/Manifest.toml
 1 file changed, 645 insertions(+)
 create mode 100644 docs/Manifest.toml

By force committing docs/Manifest.toml file, the instantiate() command in

PlotDocs.jl/.github/workflows/docs.yml

Lines 56 to 57 in 7f1da68

	xvfb-run julia --project=docs/ -e 'using Pkg; Pkg.develop(PackageSpec(path=pwd()));
	Pkg.instantiate()'

will use that specific DemoCards.jl branch and build the documentation. When everything works fine, we can then delete this debug file.

[t-bltg]

CI passes, let's merge this now and see how it renders.