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: | sage-9.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/sage-devel/c/Acy5nNZWaUA/m/DuqGh3JkCwAJ and https://groups.google.com/g/sage-devel/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/Pending||width=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/\([0-9]*\)|#\1\]\],#\1,g;/^=/s/ \ ([A-Z][a-z][a-z]*[A-Z]\)/ !\1/g;' INPUT > OUTPUT
- https://trac-hacks.org/wiki/MoinToTracScript (untested)
We also audit/update our documentation regarding links to the wiki.
$ git grep 'wiki[.]sage'
Related content migration tickets:
- #30500 Meta-ticket: document configuring IDEs and text editors
- #31533 Migrate old Sage release tours from Sage wiki to Sage documentation (new)
- #31164 Meta-ticket: 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 follow-up: ↓ 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 --enable-editable and --enable-download-from-upstream-url
|
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, HP-UX
|
9ca39a2 | README.md: Point to developer guide for git details
|
f1e1166 | src/doc/en/installation/source.rst: Point to README.md for step-by-step 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/spkg-configure.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://trac-hacks.org/wiki/MoinToTracScript?
comment:27 Changed 2 weeks ago by
- Milestone changed from sage-9.6 to sage-9.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).