Mount Sneffels

From Dissent
Jump to navigation Jump to search

Mount Sneffels is a Python framework for converting a CSV file to pages for the LPRC Button and Sticker Guide. It's written and and currently maintained by James Gholston.


Configuration file should be saved in a robust format such as .ods until it's time to feed it into Mt Sneffels. Then save it as a .csv file (comma separated values text, UTF-8 or maybe 7 bit ASCII for best results)

Comments in the spreahsheet start with a number sign (#) in the NAME column and are ignored unless they're a setting value that starts with a hashbang (#!) which a small part of the engine will look at to find settings declared in the spreadsheet/CSV file.

If a setting, place its value, if any, in the SORT column.

Spreadsheet Columns and What Should Go In Them

  • NAME

Message on or terse description of button. This is also used for anchor tags. Avoid commas. MUST BE UNIQUE WITHIN THE SPREADSHEET

  • SORT

How to sort this. ie without articles. ...Or perhaps if the listed name isn't how to sort at all For use in your spreadsheet software; ignored by Mt Sneffels unless it's a setting value Mt Sneffels depends on the spreadsheet already being sorted.

  • DESCR

Explanation of button message. Include full name or term of anything that's an abbreviation or acronym on the button and source of button message if known. If specific to a single state, say it here.

  • SEE_INSTEAD

If this is here to direct the reader to elsewhere, that elsewhere goes here. Must be a valid NAME or a comma separated list of valid NAMEs These items should only have NAME, SORT, and SEE_INSTEAD populated

  • SEE_ALSO

Related message(s) that might be of interest, especially if this one isn't available at the event table Must be a valid NAME or a comma separated list of valid NAMEs

  • Descr_Auth

Who wrote the description. Internal documentation only, unused by Mt Sneffels

  • Longdescr_Auth

Who wrote the long description, if different from short description authorship. Internal documentation only, unused by Mt Sneffels

  • STRUCT

Which structural category? One application of this information is to better separate into specialized button sets.

  • TOPIC

Which topic category? One application of this information is to better separate into specialized button sets.

  • LPRC Tier

Tier assignment to assist with quantities in sets; designed for the audiences that LPRC template is aimed at

I: High Demand & Core Principles
II: Strong and Popular Libertarian Stances
III: Targeted Policy Advocacy
IV: Deep Libertarian Concepts
V: Special Interest & Complex or Very Low Demand

Internal documentation only, unused by Mt Sneffels

  • CSLSIDE

Does this have outreach versions? (mostly deprecated and only used as a fallback). Yes the name of this column is a misnomer as it includes more than just CSLSide.

  • LPRC

Does this have LPRC versions? (mostly deprecated and only used as a fallback)

  • SETS

List of sets this is included in. Only for sets that don't have their own columns in this spreadsheet. Use a comma separated list of sets if more than one. Best reserved for sets that have a very small set of messages. If it has a bunch, declare a column for it in #!setcolumns instead.

  • IMG

Name of the image showing this. Must have for release builds.

  • 25

1 if available in 25mm outreach, otherwise leave blank.

  • O32

1 if available in 32mm outreach, otherwise leave blank.

  • O44

1 if available in 44mm outreach, otherwise leave blank.

  • O58

1 if available in 58mm outreach, otherwise leave blank.

  • O75

1 if available in 75mm outreach, otherwise leave blank.

  • OSQ

1 if available as square outreach, otherwise leave blank.

  • RSQ

1 if available as square LPRC, otherwise leave blank.

  • R25

1 if available in 25mm LPRC, otherwise leave blank.

  • R32

1 if available in 32mm LPRC, otherwise leave blank.

  • R44

1 if available in 44mm LPRC, otherwise leave blank.

  • R58

1 if available in 58mm LPRC, otherwise leave blank.

  • R75

1 if available in 75mm LPRC, otherwise leave blank.

  • Allbuttons

Date current versions added to AllButtonSort or best guess
YYYY-MM-DD format
If 2023-03-25 or earlier, set to 2023-03-25
Internal documentation only, ignored by Mt Sneffels.

  • LPRC 240 58mm, Et C

Indications of presence in various button sets. Depend on setcolumns setting being correctly parsed by Mt Sneffels


Spreadsheet-Controlled Settings

  • #!basename

Used to automatically create directory and file names. For example, Colson_Mill_Catalog_

  • #!notice

Does there need to be a notice or description at the top? Put it here. Not yet supported

  • #!cssfile

Now supports importing a CSS file. This is the global CSS. Page-specific CSS is specified elsewhere and not yet supported.

  • #!width

Width of contentboxes. Include CSS units (ie 3.5in) -- default is unset and that's an option Support is currently broken. Just hard code it into the CSS file for now.

  • #!columns

How many columns on each page? Default is 2 Support is currently broken. Just hard code it into the CSS file for now.

  • #!colwidth

column width. Include CSS units (ie 3.5in) Support is currently broken. Just hard code it into the CSS file for now.

  • #!imgwid

Fixed width of item images. Include CSS units (ie 3.33in) Support is currently broken. Just hard code it into the CSS file for now.

  • #!debug

Debugging level. 0 for almost nothing; 11 to be insane about it

  • #!missing_img

Name of image file to use when the one it's supposed to have is missing

  • #!headtitle

What to display as the title of the generated HTML page?

  • #!headline

What to display as the title within and at the top of the HTML page itself.

  • #!headboxheight

How much room to make for the headline and notice? Include CSS units (ie 1in) Support is currently broken. Just hard code it into the CSS file for now.

  • #!debug

Set to 0 for minimum debugging output; set to 11 to be insane about it.

  • #!strict

Set to 1 or greater to be obnoxious about detected problems; set to 11 to be as obnoxious as possible.

  • #!nosave

Do we actually save this (set to 0) or just pretend really hard (set to 1)

  • #!setcolumns

Extra columns for set data. Separate with commas.

  • #!longdescr

Preferentially use verbose descriptions when available (set to 1), or prefer short descriptions (set to 0). As of Colson Mill, there are very few long descriptions.

Retrieved from "https://work.radicalcaucus.org/index.php?title=Mount_Sneffels&oldid=1456"