Wolfram Mathematica

« first day (3284 days earlier) ← previous day next day → last day (1190 days later) »

2:11 AM

Hi all. Anybody know the most up-to-date method for creating package documentation to integrate with the doc center (or to host on one's own site with the same style)? I've seen ApplicationMakerbut note it hasn't been updated for 6-7 years.

3 hours later…

b3m2a1

5:00 AM

@AntiEarth There is none 🙃WRI never released anything and no community effort has ever gotten enough buy in to become the defacto standard

You can make stuff with the Workbench plugin for Eclipse but it'll look old

I just opted to make stuff that didn't even try to look like the WRI docs & which I could export to Markdown, but I don't really write Mathematica code anymore so I haven't touched that in a few years

This is an example of the docs I'd build

This is what I'd use to build that: github.com/b3m2a1/SimpleDocs but as you can see I haven't touched it in 2 years

4 hours later…

Anti Earth

8:45 AM

Aw that's disheartening :(

It seems like it'd be relatively straightforward to convert a notebook containing the contents of a doc page into e.g. a html file. A pity it's not so straightforward :(

I'll check that out, cheers!

6 hours later…

Chris K

2:49 PM

@AntiEarth With massive help from folks here, especially @Szabolcs & @JanPöschko, I've cobbled together an unwholesome workflow based on Workbench, some extra scripts, using an archived version of 10.0, and then uploading the results to Wolfram Cloud

see <https://www.wolframcloud.com/obj/EcoEvo/docs/guide/EcoEvo.nb> for example

it's accreted over time, so I don't think I could give a step-by-step guide

I'm just hanging on while the Wolfram Paclet Repository is being perfected

(might be a while)

3 hours later…

b3m2a1

5:40 PM

@AntiEarth it's relatively straightforward, but there're just so many different content types that it can be tough to get a robust version. I found Notebook -> Markdown to be the best approach, since Markdown can be ingested by any number of different site generators/platforms to make documentation

Feeds

6:26 PM

Wolfram Blog: How We Navigated a Hybrid Remote Learning Environment Using Wolfram Technology

posted on January 14, 2021 by Timothy Newlin

The past year of learning ushered in a variety of new experiences for instructors and students alike. In addition to masks in the classroom, reduced class sizes to allow for social distancing, rigorous testing and tracing efforts, and precautionary remote video classes, we have also needed to adjust aspects of our teaching styles. While such [...]

Anti Earth

6:39 PM

@ChrisK that looks like a great effort, thanks very much! It is a pity wolframcloud makes things a little laggy - I'd prefer all code to run once at doc-creation time, and deliver only html. I'm not sure I can be so patient! :)

@b3m2a1 Is 'Notebook -> Markdown' a tool? I can't see a way to export a notebook to markdown via the Mathematica frontend

b3m2a1

@AntiEarth Nah but @Kuba has written a converter, I've written one, I think some people inside WRI may have written one for Wolfram Community, etc.

There are a wealth of those