I've been sitting on a piece of script that I wrote for a few days wondering what to do with it, or exactly where to post it in the monastery. I imagine it needs to go in Craft, but my indecision drove me to an idea:

Would it be possible to have block of text in Craft in which to discuss the code we post in addition to the line-numbered code format already provided? I'm not familiar with the Everything code, and while I'm sure it's feasible, I'm not sure if the effort would be worth investing in. I see the perks of having the numbered code format, but am not sure if the lack of such a feature as I describe was intentionally omitted. I would welcome other's opinions and insights here.

The code I would like to post is not difficult to understand, but the concepts could use some explanation to those unfamiliar with what it is I am doing. I know I could simply provide long, in-depth comments describing things. . . but somehow that seems a little less elegant. I'm all for good commenting of code, but not for dissertations within my code. Again, discussion is welcome here.

Perhaps another alternative would be to make Craft behave like other nodes, requiring that CODE tags be placed around the code we wish to show off. To get the same nicely-numbered format that we have now, maybe CODE tags can be expanded to number lines, or create a separate set of tags that provide that same format.

Thanks for listening. Looking forward to discussion!

MrCromeDome

In reply to New feature for Craft section? by MrCromeDome

Title:
Use:  <p> text here (a paragraph) </p>
and:  <code> code here </code>
to format your post, it's "PerlMonks-approved HTML":


  • Posts are HTML formatted. Put <p> </p> tags around your paragraphs. Put <code> </code> tags around your code and data!
  • Titles consisting of a single word are discouraged, and in most cases are disallowed outright.
  • Read Where should I post X? if you're not absolutely sure you're posting in the right place.
  • Please read these before you post! —
  • Posts may use any of the Perl Monks Approved HTML tags:
    a, abbr, b, big, blockquote, br, caption, center, col, colgroup, dd, del, details, div, dl, dt, em, font, h1, h2, h3, h4, h5, h6, hr, i, ins, li, ol, p, pre, readmore, small, span, spoiler, strike, strong, sub, summary, sup, table, tbody, td, tfoot, th, thead, tr, tt, u, ul, wbr
  • You may need to use entities for some characters, as follows. (Exception: Within code tags, you can put the characters literally.)
            For:     Use:
    & &amp;
    < &lt;
    > &gt;
    [ &#91;
    ] &#93;
  • Link using PerlMonks shortcuts! What shortcuts can I use for linking?
  • See Writeup Formatting Tips and other pages linked from there for more info.