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:

Status badges

Description (last modified by mkoeppe)

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:

See

Change History (27)

comment:1 Changed 5 weeks ago by mkoeppe

  • Description modified (diff)

comment:2 Changed 5 weeks ago by mkoeppe

  • Description modified (diff)

comment:3 Changed 5 weeks ago by mkoeppe

  • Description modified (diff)

comment:4 follow-up: Changed 5 weeks ago by tmonteil

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).

comment:5 Changed 5 weeks ago by dimpase

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 mkoeppe

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 mkoeppe

  • Priority changed from major to critical

comment:8 Changed 5 weeks ago by mkoeppe

  • Cc chapoton added
  • Description modified (diff)

comment:9 Changed 5 weeks ago by mkoeppe

  • Description modified (diff)

comment:10 Changed 4 weeks ago by mkoeppe

  • Description modified (diff)

comment:11 Changed 4 weeks ago by mkoeppe

  • Cc saraedum added

comment:12 Changed 4 weeks ago by mkoeppe

  • Description modified (diff)

comment:13 Changed 4 weeks ago by mkoeppe

  • Branch set to u/mkoeppe/migrate_wiki_sagemath_org_to_trac_sagemath_org_wiki

comment:14 Changed 4 weeks ago by git

  • Commit set to 57fc849fc561584a8ae726ed6d30162c003e1445

Branch pushed to git repo; I updated commit sha1. New commits:

57fc849configure.ac: Remove outdated advice regarding exotic platforms

comment:15 Changed 4 weeks ago by mkoeppe

  • Dependencies set to #33088

comment:16 Changed 4 weeks ago by git

  • Commit changed from 57fc849fc561584a8ae726ed6d30162c003e1445 to 45c1a394ae75fad31da2d85e9a3e1481f37540a6

Branch pushed to git repo; I updated commit sha1. Last 10 new commits:

b46c953README: Document --enable-editable and --enable-download-from-upstream-url
a3ffe84README.md: Instructions for Apple Silicon
d7708dfREADME.md: Restructure macOS prep instructions
2e1d22dsrc/doc/en/installation/source.rst: Remove instructions for Solaris, AIX, HP-UX
9ca39a2README.md: Point to developer guide for git details
f1e1166src/doc/en/installation/source.rst: Point to README.md for step-by-step instructions
3f6c6e0src/doc/en/developer/workspace.rst: Link to Trac #30500
8716d80src/doc/en/installation/source.rst: Update required venv Python extension modules from build/pkgs/python3/spkg-configure.m4
10c9b87Merge #33088
45c1a39src/doc/en/developer/trac.rst: Update wiki URL for patchbot

comment:17 Changed 4 weeks ago by mkoeppe

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 mkoeppe

  • Description modified (diff)

comment:19 Changed 4 weeks ago by mkoeppe

  • Description modified (diff)

comment:20 Changed 4 weeks ago by mkoeppe

  • Description modified (diff)

comment:21 Changed 4 weeks ago by mkoeppe

  • Description modified (diff)

comment:22 Changed 4 weeks ago by mkoeppe

  • Description modified (diff)

comment:23 Changed 4 weeks ago by mkoeppe

  • Description modified (diff)

comment:24 Changed 4 weeks ago by git

  • Commit changed from 45c1a394ae75fad31da2d85e9a3e1481f37540a6 to da69787e997cefccb398a6dee9258ecfda3a26d0

Branch pushed to git repo; I updated commit sha1. New commits:

da69787src/doc: Fix 'hardcoded link could be replaced'

comment:25 Changed 3 weeks ago by mkoeppe

  • Cc klee added
  • Description modified (diff)

comment:26 Changed 3 weeks ago by mkoeppe

@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 mkoeppe

  • Milestone changed from sage-9.6 to sage-9.7
Note: See TracTickets for help on using tickets.