[mapserver-dev] Versioned MapServer Docs?

[Brent Fraser]

I too use a editor with [imperfect] syntax highlighting (Notepad++).  But i wanted to go beyond that (your Vim -> html is a nice option).  

My goals for the "mapfile cheatsheet" are:

1.  Make it easy to create a workable mapfile 
 - can simply cut-and paste
 - content should be almost complete
 - have comments showing options, acceptable values, etc for tweaking
2.  Make it available for others to use (e.g. a web page)
3.  Provide links on the keywords pointing to the official doc for details (.rst? .md?) 
 - show syntax highlighting for ease of reading
4.  Make it easy to maintain/update as the mapfile syntax changes

Loved your DATA statement by the way!

Brent

----------------------------------------

From: "Basques, Bob (CI-StPaul)" <bob.basques at ci.stpaul.mn.us>
Sent: 3/19/21 10:35 AM
To: "bfraser at geoanalytic.com" <bfraser at geoanalytic.com>, "mapserver-dev at lists.osgeo.org" <mapserver-dev at lists.osgeo.org>, "Jeff McKenna" <jmckenna at gatewaygeomatics.com>
Subject: Re: [mapserver-dev] Versioned MapServer Docs?

I use VI(M)  for Syntax (There is a VI systax file for MapServer that I have used forever . . .) Works really nicely, I can also export the color Syntax as an HTML file . . . works really nice for Presentation and stepping through code, etc. . .  it even has controls for deprecated stuff . . .

From: Brent Fraser <bfraser at geoanalytic.com>
Reply-To: Brent Fraser <bfraser at geoanalytic.com>
Date: Friday, March 19, 2021 at 11:05 AM
To: Bob Basques <bob.basques at ci.stpaul.mn.us>, "mapserver-dev at lists.osgeo.org" <mapserver-dev at lists.osgeo.org>, Jeff McKenna <jmckenna at gatewaygeomatics.com>
Subject: Re: [mapserver-dev] Versioned MapServer Docs?

Bob,

Here's a snip of what I've got so far (see attached).

- It's laid out to copy-and paste to a text file for for tweaking

- I like the syntax highlighting of .rst (thanks Jeff?) (not possible with markdown)

- I plan to add links to doc at the keywords (possible with markdown, not with .rst?)

Brent

 
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osgeo.org/pipermail/mapserver-dev/attachments/20210319/cc6d5be5/attachment.html>