Kolmafia - User contributions [en]

Talk:String Handling Routines

2007-11-07T04:46:17Z

Kazim: More dead spam

So wtf does group_string actually do? The linked "descriptive" post has an utterly unhelpful example. Has anyone ever used it for anything?

Groups a string into a map using a regular expression. To understand the function you must know.
1. What maps are and how they are used.
2. Understand what regular expressions are and how to create them.

Using the original post:

FUNCTION DEFINTION: string [int,int] group_string( string source, string regex )
EXAMPLE: string [int,int] test = group_string( "This is a test", "([a-z] ) " );

Example Breakdown:
'''string [int,int]''' Define a map. Two dimensional. The indices are integers. The data is stored as a string.
'''test''' Define the map with name '''test'''.
'''group_string''' Call the function.
'''"This is a Test"''' Feeding the function a sample string.
'''"([a-z] ) "''' Your regular expression.

Regular expressions deal with pattern matching. You want the function to find a particular pattern. The function then returns that pattern, or the stuff before it, or the stuff after it, or splits them appart, or squeezes them together. So what does this regular expression look for?
'''The Parenthesis ():''' Tell the function this is a group of characters.
'''[a-z]:''' Tell us they will be lower case letters.
''' :''' Tell us to look for one or more characters.
That space between the ) and " Tells us the pattern ends in a space.

Thus reading down the string.
T = Does not match [a-z] is a capital letter.
h = Matches [a-z]. Starting Group
i = Matches [a-z]
s = Matches [a-z]
= Matches space. First group found and is "his "
i = Matches [a-z]. Starting Group
s = Matches [a-z]
= Matches space. Second group found, and is "is "
a = Matches [a-z]. Starting Group
= Matches space. Third group found, and is "a "
t = Matches [a-z]. Starting Group
e = Matches [a-z]
s = Matches [a-z]
t = Matches [a-z]
End of line. No more matches. Stop.

Thus, trusting the post, the map would be:

test[0][0] => "his "
test[0][1] => "his"
test[1][0] => "is "
test[1][1] => "is"
test[2][0] => "a "
test[2][1] => "a"

I personally haven't used it. Would be used in parsing a page by hand.

Talk:Main Page

2007-11-07T04:42:09Z

Kazim: I am the spam slayer!

Save these links for now:

== Getting started ==

* [http://www.mediawiki.org/wiki/Help:Configuration_settings Configuration settings list]
* [http://www.mediawiki.org/wiki/Help:FAQ MediaWiki FAQ]
* [http://mail.wikipedia.org/mailman/listinfo/mediawiki-announce MediaWiki release mailing list]
21895299452399151244860

== Wiki layout... ==

We really should consider exactly how to lay out the wiki... We should probably see how others (especially the KoL wiki) do it and take inspiration... :)

Also, I'm thinking we should eventually have a page for each function, to make searching the wiki more valuable... :)

--[[User:Daychilde|Daychilde]] 23:00, 8 January 2007 (CST)

I agree with your idea about one-page-per-function.

Also I think every* function's documentation should show a real-world example of use. The links to example scripts are a good start in this direction, but some code to read right on the function page would be nice. (*Yes, even the "you are not cool enough to use this" undocumented stuff.)

A master ASH function list page would be helpful. When trying to Find a keyword in browser to see if KM implements a given functionality, it's a minor PITA to have to click into each categorized page and search them all individually.

Also welcome would be some kind of icon, color, or other indicator for newly-added functions. Master list sorted/sortable by implementation version/date if possible.

Also, on the subject of general layout/UI improvements (since you asked): for the main page, I prefer a high-level bulleted-listy index/ToC, kinda like the ToCs on the current sourceforge manual pages. Personally, I find this more useful than the increasingly popular "widgety-portaly-stocks-news-and-weather" look.

Redundancy should be removed wherever possible -- e.g. (ASHRM) in front of every link. I understand if prefixes of that sort are there to assist in organizing the underlying database, but if not, I think they are totally unnecessary and a distraction -- that is, provided the containing page is appropriately identified with a nice big "ASH Reference Manual" heading at the top, breadcrumbs, etc.

I'll quit before I arrive at a frenzy of usability fanaticism the likes of which would make J. Nielsen repent like a dirty sinner. (Got work to do, actually. Now maybe if there was a "job opportunities" section.......)

--[[User:somebody who sincerely appreciates not having to register/login and probably wouldn't participate elsewise]] 12:35, 30 January 2007 (EST)

On the other hand, speed-bumping idiot apammers may be worth it. I could go on for ages about how offensive I find that kind of griefing (If you think life isn't a game, you're doing it wrong)--[[User:Metraxis|Metraxis]] 11:27, 18 February 2007 (CST)

== Updating? ==
Let's get started, guys. Soon enough, I'll have a list of all the functions, which I think should go in a wiki page to (as someone above said) search and link. Also, is there a way to do monospacing with code? --[[User:MagiNinjA|MagiNinjA]] 00:35, 29 March 2007 (CDT)
:You can get mono-spaced text by using <code> tags. For example, using <pre><code>EXAMPLE TEXT</code></pre> produces this as a result. <code>EXAMPLE TEXT</code>
:If you need anymore help, just drop me a line on my [[User_talk:Ksumoe|talk page]]. [[User:Ksumoe|ksumoe]] <sup>([[User_talk:Ksumoe|talk]]  [[Special:Contributions/Ksumoe|contrib]])</sup> 18:35, 10 April 2007 (CDT)

== Ideas... ==

These are my ideas that I have floating around in my head:
# A template to put all the relevant information about a function into a table (with proper colored backgrounds and such)
## I can do this; I just need to know what information is 'relevant'.
# Move this type of discussion to the Community Portal. Right now the CP is just a bunch of links (we can make a 'links' page and add it to the sidebar if needed).
# An overhaul of the main page. Someone said that they don't like the 'portal' type of look, but that kind of look has become the ''de facto'' standard for wikis, as it is the most popular. I'll pound out a rough draft on a subpage of my user space.
# Creation of a template structure. Templates for requesting deletion, protection, etc. That way non-sysop flagged users can 'tag' pages [[Talk:Bad title|such as this]] for deletion.
# Logo! 'Cause we need to be cool like that.
# Define a category structure. Do it now before too many pages get created.

Like I said... I'm here to help. [[User_talk:Ksumoe|Comments]]  plox. [[User:Ksumoe|ksumoe]] <sup>([[User_talk:Ksumoe|talk]]  [[Special:Contributions/Ksumoe|contrib]])</sup> 21:17, 13 April 2007 (CDT)

I added some links on the home page -- hope that helps users find more documentation... :) -Daychilde

I corrected the Script Repository link to http://www.kolmafia.us from http://www.kolmafia.ua. ;) -Regnar

== Links to Redirects? ==

While I understand the need for redirect, why are we linking to redirect pages? Why not use <nowiki>[[Page Title|Displayed Text]]</nowiki> links instead?

== Protection ==
Seriously, protect the front page. This is getting completely destroyed by spam [[User:80.189.248.109|80.189.248.109]] 12:05, 27 August 2007 (CDT)

Is $wgSpamRegex set? If not it should be. If it is, it needs updating. Spam storming in like the flood! -divinewind420

Articles on the subject
http://nothing.tmtm.com/archives/2571
http://wiki.evernex.com/index.php?title=Blocking_Spam_in_Mediawiki
-divinewind420

Main Page

2007-11-07T04:38:32Z

Kazim: And rolled it back again

Welcome to the KoLmafia Wiki.

Please pardon our dust while we remodel.<br>
'''Progress level: [[Special:Statistics|{{NUMBEROFARTICLES}}]]'''

<table style="width:80%;margin-top: .7em;background-color:#F4DF3B;border:2px solid #8663A8">
<tr>
<td class="box_tgen" style="text-align:center;color:#000;font-size:90%;border:none;margin: 0;padding:.1em;">
'''Quick Links:''' <br> [[Your Character]] || [[Item Management]] || [[Equipment]] || [[Skills and Effects]] || [[Adventuring]] || [[In-combat functions for consult scripting]] || [[Miscellaneous]] || [[String Handling Routines]] || [[Datatype Constants]] || [[Datatype Conversions]] || [[KoLmafia Properties]] || [[Code Samples]]</td>
</tr>
</table>

== Helpful Links ==

KoLMafia:

[http://kolmafia.sourceforge.net Download KoLMafia]

[http://kolmafia.sourceforge.net/manual.html KoLMafia Documentation]

[http://kolmafia.sourceforge.net/scripting.html CLI Scripting Manual]

[http://kolmafia.sourceforge.net/advanced.html ASH Scripting Manual]

[http://kolmafia.sourceforge.net/combat.html Custom Combat Scripting Manual]

[http://www.kolmafia.us The KoLMafia Script Repository]

[http://forums.kingdomofloathing.com/vb/showthread.php?t=88408 The KoLMafia thread on the KoL Forums]

KoL:

[http://www.kingdomofloathing.com/ The Kingdom of Loathing]

[http://forums.kingdomofloathing.com/ KoL Forums]

Main Page

2007-11-04T16:15:42Z

Kazim: Rolled back spam again