Opened 5 weeks ago
Last modified 2 weeks ago
#33725 new enhancement
Migrate wiki.sagemath.org to trac.sagemath.org/wiki
Reported by:  mkoeppe  Owned by:  

Priority:  critical  Milestone:  sage9.7 
Component:  website/wiki  Keywords:  
Cc:  slelievre, dimpase, tmonteil, chapoton, saraedum, klee  Merged in:  
Authors:  Reviewers:  
Report Upstream:  N/A  Work issues:  
Branch:  u/mkoeppe/migrate_wiki_sagemath_org_to_trac_sagemath_org_wiki (Commits, GitHub, GitLab)  Commit:  da69787e997cefccb398a6dee9258ecfda3a26d0 
Dependencies:  #33088  Stopgaps: 
Description (last modified by )
As proposed in https://groups.google.com/g/sagedevel/c/Acy5nNZWaUA/m/DuqGh3JkCwAJ and https://groups.google.com/g/sagedevel/c/4ysVRpYGU_E
The Trac wiki markup appears to understand most of the old Sage wiki's markup, except:
 In section headers, CamelCase words need to be escaped with "!"
 edit the markup for included images
{{https://patchbot.sagemath.org/svg/Pendingwidth=48}}
changes to[[Image(https://patchbot.sagemath.org/svg/Pending, width=48)]]
 Replace
<<TableOfContents>>
by[[PageOutline]]
Also we can simplify some markup by replacing links to Trac tickets by just #...
.
 A command that helps with this:
sed 's/<<TableOfContents[()]*>>/[[PageOutline]]/;s,\[\ [https://trac.sagemath.org/ticket/\([09]*\)#\1\]\],#\1,g;/^=/s/ \ ([AZ][az][az]*[AZ]\)/ !\1/g;' INPUT > OUTPUT
 https://trachacks.org/wiki/MoinToTracScript (untested)
We also audit/update our documentation regarding links to the wiki.
$ git grep 'wiki[.]sage'
Related content migration tickets:
 #30500 Metaticket: document configuring IDEs and text editors
 #31533 Migrate old Sage release tours from Sage wiki to Sage documentation (new)
 #31164 Metaticket: Add user packages from https://wiki.sagemath.org/SageMathExternalPackages as optional/experimental packages
See
Change History (27)
comment:1 Changed 5 weeks ago by
 Description modified (diff)
comment:2 Changed 5 weeks ago by
 Description modified (diff)
comment:3 Changed 5 weeks ago by
 Description modified (diff)
comment:4 followup: ↓ 6 Changed 5 weeks ago by
comment:5 Changed 5 weeks ago by
I think that trac is better, as it allows contributions with github logins. And the bus factor of the present wiki hosting is rather small.
comment:6 in reply to: ↑ 4 Changed 5 weeks ago by
It's critical that we get rid of the old Sage wiki. As Dima says  it excludes new developers.
Trac is maintained because it has to be (thanks to all who keep it running!) The wiki part of it places no additional burden on maintaining Trac.
comment:7 Changed 5 weeks ago by
 Priority changed from major to critical
comment:8 Changed 5 weeks ago by
 Cc chapoton added
 Description modified (diff)
comment:9 Changed 5 weeks ago by
 Description modified (diff)
comment:10 Changed 4 weeks ago by
 Description modified (diff)
comment:11 Changed 4 weeks ago by
 Cc saraedum added
comment:12 Changed 4 weeks ago by
 Description modified (diff)
comment:13 Changed 4 weeks ago by
 Branch set to u/mkoeppe/migrate_wiki_sagemath_org_to_trac_sagemath_org_wiki
comment:14 Changed 4 weeks ago by
 Commit set to 57fc849fc561584a8ae726ed6d30162c003e1445
Branch pushed to git repo; I updated commit sha1. New commits:
57fc849  configure.ac: Remove outdated advice regarding exotic platforms

comment:15 Changed 4 weeks ago by
 Dependencies set to #33088
comment:16 Changed 4 weeks ago by
 Commit changed from 57fc849fc561584a8ae726ed6d30162c003e1445 to 45c1a394ae75fad31da2d85e9a3e1481f37540a6
Branch pushed to git repo; I updated commit sha1. Last 10 new commits:
b46c953  README: Document enableeditable and enabledownloadfromupstreamurl

a3ffe84  README.md: Instructions for Apple Silicon

d7708df  README.md: Restructure macOS prep instructions

2e1d22d  src/doc/en/installation/source.rst: Remove instructions for Solaris, AIX, HPUX

9ca39a2  README.md: Point to developer guide for git details

f1e1166  src/doc/en/installation/source.rst: Point to README.md for stepbystep instructions

3f6c6e0  src/doc/en/developer/workspace.rst: Link to Trac #30500

8716d80  src/doc/en/installation/source.rst: Update required venv Python extension modules from build/pkgs/python3/spkgconfigure.m4

10c9b87  Merge #33088

45c1a39  src/doc/en/developer/trac.rst: Update wiki URL for patchbot

comment:17 Changed 4 weeks ago by
Some pages, for example https://wiki.sagemath.org/SageMathExternalPackages, are written in RST.
The Trac wiki also supports RST  https://trac.sagemath.org/wiki/WikiRestructuredText  but it looks like it is not activated.
@dimpase, could you install docutils
(as per https://trac.sagemath.org/wiki/WikiRestructuredText#Requirements)?
comment:18 Changed 4 weeks ago by
 Description modified (diff)
comment:19 Changed 4 weeks ago by
 Description modified (diff)
comment:20 Changed 4 weeks ago by
 Description modified (diff)
comment:21 Changed 4 weeks ago by
 Description modified (diff)
comment:22 Changed 4 weeks ago by
 Description modified (diff)
comment:23 Changed 4 weeks ago by
 Description modified (diff)
comment:24 Changed 4 weeks ago by
 Commit changed from 45c1a394ae75fad31da2d85e9a3e1481f37540a6 to da69787e997cefccb398a6dee9258ecfda3a26d0
Branch pushed to git repo; I updated commit sha1. New commits:
da69787  src/doc: Fix 'hardcoded link could be replaced'

comment:25 Changed 3 weeks ago by
 Cc klee added
 Description modified (diff)
comment:26 Changed 3 weeks ago by
@tmonteil, would you be able to provide me with a snapshot of the moinmoin wiki data, so I can try out the script https://trachacks.org/wiki/MoinToTracScript?
comment:27 Changed 2 weeks ago by
 Milestone changed from sage9.6 to sage9.7
Please don't. In terms of infrastructure, the wiki is pretty well hosted, while the VM that hosts the trac+wiki is unmaintained, so this looks like a regression to me (at least right now).