A WorkLife FrameWork Blog


About A WorkLife FrameWork | Purchase

The Mathematica Documentation Center

Posted on: Friday, April 18, 2008 at 07:41 PM UT  Notebook Version

It is not a very simple matter to add new material to the Mathematica Documentation Center.  One key reason is that Wolfram Research has not yet released tools to doing this.  One suite of such tools will reside within Wolfram WorkBench, and the version of WorkBench that contains these is currently in Beta.  A set of tools will also be included in the next version of A WorkLife FrameWork.

The Documentation Center tools included in Wolfram WorkBench require that your locus for you work be centered n WorkBench: this is the habit of some Mathematica programmers  and this services that community.  The tools that will be included in A WorkLife FrameWork are strictly Mathematica-centric and allow you to keep your work's focus within Mathematica.  In this way the two different toolsets are helpfully complementary.

The tools contained in the next version of A WorkLife FrameWork will enable you to convert arbitrary notebooks into a form that can automatically be placed in the Documentation Center—this includes documentation for packages that you write and wish to distribute to others.  But it also includes documents—in the absence of a package—that you want to distribute so that people can read and interact with them through the Documentation Center.

The Mathematica Documentation Center is actually a very plastic environment for adding material to Mathematica, but to do so you currently need to understand quite a bit of arcana that pertains to Paclets and to the formatting and tagging of notebooks.   There have been many questions over the past year or so on MathGroup on how to format and prepare material for the Mathematica Documentation Center.  And in the course of creating tools for the next version of A WorkLife FrameWork I have learned quite a bit about how to do this.  So, in the interest of helping people at least get started on this, I wrote up some of what I have learned so that I could share it with the larger Mathematica community.  I have placed this write-up in a Mathematica notebook which you can download from here: http://www.scientificarts.com/worklife/notebooks/

I hope that this is helpful to folks....

Permalink | Notebook Version | Comments | Send Comment...

Recent Posts

Blogged From
WorkLife FrameWork

RSS Feed

8/4, 2009; 8:53 PM:
Documenting Screencast
11/19, 2008; 11:28 AM:
Mathematica 7 and A WorkLife FrameWork 3.0
11/17, 2008; 3:51 PM:
A Notebook Tagging Tutorial
4/18, 2008; 3:41 PM:
The Mathematica Documentation Center
3/2, 2008; 4:01 PM:
Security Tools
12/10, 2007; 12:26 AM:
December Discount
10/1, 2007; 11:09 PM:
Creating a new Stylesheet: an exercise in refinement
7/28, 2007; 3:04 PM:
Where is WorkLife Going? And why was version 2.0 ready when Mathematica 6 was released?
7/17, 2007; 10:28 PM:
A Practical Matter: Restarting WorkLife
7/10, 2007; 11:12 PM:
Almost nothing to do with A WorkLife FrameWork, but time will tell...
6/28, 2007; 1:01 PM:
A WorkLife FrameWork: It is Many Applications...
6/19, 2007; 10:59 AM:
A New Screencast: Getting Started
6/15, 2007; 10:33 AM:
Notebook History comment...
6/10, 2007; 10:07 PM:
Nonlinear Work Habits and Tagging
6/10, 2007; 6:29 PM:
A Palette for Standard Packages
6/9, 2007; 11:19 AM:
A discussion
6/3, 2007; 10:03 PM:
A MathGroup Posting
5/28, 2007; 9:33 PM:
A WorkLife FrameWork is now compatible with version 6 of Mathematica
5/22, 2007; 9:36 PM:
Email Analysis Tools
5/22, 2007; 9:27 AM:
The Palettes Menu
5/20, 2007; 11:14 PM:
Soon, very soon...
5/3, 2007; 11:09 AM:
Mathematica 6 Released: A WorkLife FrameWork 2.0 to follow very soon...
3/21, 2007; 1:50 PM:
A WorkLife FrameWork mention on MacinTouch
2/22, 2007; 1:40 PM:
More screencasts...
2/19, 2007; 12:42 AM:
New Screencasts
12/30, 2006; 7:51 PM:
Organizational Choices
11/26, 2006; 10:54 PM:
Updated Version of A WorkLife FrameWork.
11/10, 2006; 12:30 AM:
A quote and a testimonial...
11/6, 2006; 2:09 PM:
Version 1.1 on its way
10/31, 2006; 3:32 PM:
Another blog mention of A WorkLife FrameWork
10/23, 2006; 10:54 AM:
Finding A Diary or Notebook
10/10, 2006; 9:45 PM:
At the Wolfram Technology Conference
10/8, 2006; 11:35 AM:
The Wolfram Technology Conference
9/27, 2006; 10:51 AM:
Menu Items on Custom Palettes
9/21, 2006; 10:50 AM:
A Tip: Multiple disks or partitions
9/20, 2006; 3:57 PM:
A bit of Blogosphere notice
9/18, 2006; 9:24 PM:
Opening a set of files
9/14, 2006; 11:25 PM:
An Email Trick--slightly advanced
9/14, 2006; 11:08 PM:
The most current version...
9/11, 2006; 1:00 PM:
Finally Released!


Mathematica Google Group
Scientific Arts

All material on this website Copyright © 2005-2009, Scientific Arts, LLC.