Difference between revisions of "explain xkcd:Community portal/Proposals"

Explain xkcd: It's 'cause you're dumb.
Jump to: navigation, search
(Allow external inline images)
(How to reference strips?: new section)
Line 468: Line 468:
 
:* Mediawiki itself will tell us when a potentially expensive parser function is being used too much, by placing the corresponding page in [[:Category:Pages with too many expensive parser function calls]]. So we don't need to be concerned with {{w|premature optimization}} :)
 
:* Mediawiki itself will tell us when a potentially expensive parser function is being used too much, by placing the corresponding page in [[:Category:Pages with too many expensive parser function calls]]. So we don't need to be concerned with {{w|premature optimization}} :)
 
:--[[User:Waldir|Waldir]] ([[User talk:Waldir|talk]]) 19:16, 8 August 2012 (UTC)
 
:--[[User:Waldir|Waldir]] ([[User talk:Waldir|talk]]) 19:16, 8 August 2012 (UTC)
 +
 +
== How to reference strips? ==
 +
 +
I think we need to agree on a citation style for strips in plain prose. I.e. If the [[Black Hat]] article says "Black Hat first appears in ________", how are we filling that blank? In this case, the blank is [[29: Hitler]]. As I understand it, proper style for an "episode" name typically is quotes, so the stip is "Hitler". But there's still various options:
 +
 +
# "[[29: Hitler|Hitler]]"  [quotes not linked]
 +
# [[29: Hitler|"Hitler"]]  [quotes linked]
 +
# [[29: Hitler|Comic #29]]
 +
# [[29: Hitler|#29]]
 +
# [[29: Hitler]]
 +
# "[[29: Hitler|Hitler]]" (29)
 +
# "[[29: Hitler|Hitler]]" (#29)
 +
 +
etc.
 +
 +
Anyone have any opinions?

Revision as of 21:38, 8 August 2012

Community Portal
Dialog-information on.svg

Proposals (+post)
Place for ideas and suggestions to improve the wiki's design and organization on general issues.

Preferences-system.svg

Technical (+post)
Technical issues regarding the site, including bug reports or MediaWiki extensions requests.

Edit-find-replace.svg

Coordination (+post)
Community-managed page for coordinating content editing and maintenance tasks.

Tools-hammer.svg

Admin requests (+post)
Problems requiring assistance from an admin. User problems, changes to protected pages, etc.

Help-browser.svg

Miscellaneous (+post)
Place for general chit-chat about virtually anything that doesn't fit anywhere else.

View all community portal sections at once here
Hyperlink-internet-search.svg

Tagline

I haven't created MediaWiki:Tagline yet, but we need to think about what to put there. That's the familiar "From Wikipedia, the free encyclopedia." over at Wikipedia - it appears right under the title of each page. --Philosopher Let us reason together. 10:39, 1 August 2012 (EDT)
Moved from Explain XKCD:Community portal --Philosopher Let us reason together. 00:09, 4 August 2012 (EDT)

I think it's pretty obvious we should keep the "It's cause you're dumb." :) --Waldir (talk) 13:20, 6 August 2012 (UTC)

Separate discussion page(s)

I think we should create a separate Discuss the wiki page, so that each discussion can go under its own header. I'd suggest setting up a todo list where people can help out. I'd start with a suggestion:

We should be using cleaner urls. Maybe this tool can help setting that up. --Waldir (talk) 05:46, 2 August 2012 (EDT)
Whatever we do decide, I've created {{xkcd}} and {{explain}} templates to create links to the xkcd site and other explanations here on this site; that should factor at least those sites (nice central administration) as well as helping us categorize pages that use them. Was thinking of also {{wiki}} for the same benefit, even if there's already a prefix built into mediawiki... the only drawback is the bias toward the en side... IronyChef (talk) 10:31, 2 August 2012 (EDT)
I'm liking the idea of creating a Discuss the wiki page - I'll start one if someone doesn't/hasn't beat me to it and add it to the sidebar. I'd asked for better URLs at User talk:Jeff#Robots.txt, though I didn't know what they were called. --Philosopher Let us reason together. 17:17, 2 August 2012 (EDT)
I also like the idea of the {{xkcd}} tags. On a related note, I've imported {{tl}}.  :-) I also realize we don't have a secure server here, but I'd support the best practice of beginning URLs with protocol-relative links ( // instead of http:// or https:// ) anyway, especially since the xkcd website itself appears to be https-compatible.Nevermind, it doesn't seem to be. So I guess it doesn't matter. --Philosopher Let us reason together. 22:40, 2 August 2012 (EDT)
Maybe we can create a subpage of the community portal for the wiki discussion. What do you think? --Waldir (talk) 04:32, 3 August 2012 (EDT)
Also one for editing coordination (see User:SurturZ/sandbox for instance), another for mediawiki assistance (requests to admins perhaps on the same page, or on a separate one). Any other ideas? --Waldir (talk) 04:41, 3 August 2012 (EDT)

Moved from Explain XKCD:Community portal, may need to be broken out into new headers or sub-headers. --Philosopher Let us reason together. 00:12, 4 August 2012 (EDT)

Great job on creating the subpages! I think the subpages can be made more intuitive for newcomers, though. Here are my subbestions:

  • merge "/Design" and "/Proposals" into "/Discuss the wiki" or "/Improve the wiki" or something to that effect.
  • rename "/Technical" into "/Tecnical assistance" so it is clear that it should be used for one-off issues rather than coordination of wiki-wide changes (which should go in the section above)
  • merge the "/Administrator's noticeboard" above? That would reinforce that adminship is nothing but a set of technical tools to assist the wiki
  • New "/Editing coordination" subpage for organizing what to do, maintenance, keeping a TODO list for newcomers to tackle, etc -- essentially like WikiProjects work at Wikipedia.

--Waldir (talk) 04:35, 4 August 2012 (EDT)

As I see this, it would involve mostly just renaming pages. I don't particularly care what the names are, so I won't comment on that.
  • I'd like to keep /Administrator's noticeboard for the time being. The primary advantage of this is that administrators can watchlist this and things which need the tools are less likely to get lost in discussion. It can always be deprecated afterwards if it isn't being used enough.
  • I'd sort of seen /Design as doing what you're proposing for /Editing coordination, though I didn't explain it as well.
--Philosopher Let us reason together. 18:43, 4 August 2012 (EDT)
Ok, I get what you mean with the Admin page. I don't think this wiki is going to be that busy to warrant a separate page, though. But for now, let's at least simplify the name? "Admin requests", for instance :)
And yeah, Design isn't really a good name for content-related coordination. What I'm suggesting here is to have one page for meta (wiki-related) discussion, and another for content-related discussion. Does that make sense? And what name do you think would be good for the former rather than the current, too generic imo, "Proposals"? --Waldir (talk) 19:20, 4 August 2012 (EDT)
"Discuss the wiki" sounds good to me, as does "Admin requests." Or whatever, I guess.  ;-) I may not be online much for the next few days (or much this evening), so go ahead and change it how you think it should be, I guess. Having stable discussion pages sooner than later would be good. --Philosopher Let us reason together. 01:48, 6 August 2012 (EDT)
Ok I changed the admin page name, and merged "design" and "proposals", but for now I left it named "Proposals". I'm not quite confident about the clarity of "Discuss the wiki"... I'll wait until others comment here. --Waldir (talk) 14:06, 6 August 2012 (UTC)

Automatic Import

Hi

I created a draft for the comic pages. It's still work in progress, but I'd like to retrieve feedback.

Also, maybe we could autmatically import comics using the JSON data Randall gives us ([1]). This way, we could also include transcripts. --SlashMe (talk) 15:23, 1 August 2012 (EDT)

Hm, I should add a link to my draft: User:SlashMe/Testpage ;-) --SlashMe (talk) 06:54, 2 August 2012 (EDT)

I updated the page, including links to the next/previous comic similar to Template:ComicHeader. I used comic 472, because it has a lot of metadata (link, news, HTML title, etc.). --SlashMe (talk) 07:32, 2 August 2012 (EDT)

Just to remind everyone, I'd be ready to import the comics, but I don't want to until I got more feedback. Please have a look at User:SlashMe/Testpage and tell me your opinion. --SlashMe (talk) 06:02, 3 August 2012 (EDT)

I think your test page looks great. I'm a big fan of it. Any way to fit the text in the text box rather than having it run all the way to the right? --Jeff (talk) 18:19, 3 August 2012 (EDT)
I just made a change concerning line breaks, at least it works in Firefox and Chrome. Could somebody please test it in different versions of Internet Explorer?
If you agree, I would start uploading tomorrow. I'll send you a mail. --SlashMe (talk) 18:31, 3 August 2012 (EDT)

Moved from User talk:Jeff. --Philosopher Let us reason together. 00:38, 4 August 2012 (EDT)

The discussion is now at Explain XKCD:Community_portal/Design#Header template. --SlashMe (talk) 04:20, 4 August 2012 (EDT)

XKCD Store link

I think there should be a link to the XKCD store on the left-hand navigation bar, just under "Main page". We don't want to inadvertently cost Mr Munroe money and force him back to his day job instead of drawing more XKCD :-) --SurturZ (talk) 20:23, 2 August 2012 (EDT)

I don't see a prominent store link on the blog, so I'll wait for Jeff's input before adding that one. If we do add it, should we phrase the link "XKCD store"? --Philosopher Let us reason together. 20:27, 2 August 2012 (EDT)
[2] - I'm cool with it, but maybe we put links to both xkcd and the xkcd store on the left, would be weird just to have the store link right? --Jeff (talk) 20:01, 3 August 2012 (EDT)
Heh, yeah. --Philosopher Let us reason together. 20:12, 3 August 2012 (EDT)

Moved from Talk:Main Page. --Philosopher Let us reason together. 00:42, 4 August 2012 (EDT)

I added both. I'm not quite sure about their placement, though - having them beneath the "Community portal" makes logical sense but doesn't look that great. --Philosopher Let us reason together. 01:42, 4 August 2012 (EDT)

I don't think the store link should be that prominently displayed. The sidebar is important real estate, and we should put only the most essential links there. There's no reason we'd need have the XKCD store link readily available on every page. I suggest removing it from there and adding it somewhere on the wiki (we could have a page about it, for example, and place it in the meta category). --Waldir (talk) 12:36, 4 August 2012 (EDT)
Good call, Waldir - I agree. Seems a little ostentatious over there. --Jeff (talk) 12:13, 6 August 2012 (UTC)
Ok, I'll remove it then. --Waldir (talk) 14:12, 6 August 2012 (UTC)

Centralize discussion?

There seem to be three main places for discussion about the wiki, and we need to centralize these so people can all be in sync and prevent having a mess nobody can navigate. I suggesting redirecting this page (talk:Main Page) to the Community portal, and add a large notice to Jeff's talk page also suggesting using the Community portal instead. Current discussions can be moved there. What do you think? --Waldir (talk) 16:07, 3 August 2012 (EDT)

Seems a good idea to me. --SlashMe (talk) 17:00, 3 August 2012 (EDT)
There are some suggestions on how to organize the community portal here (basically using subpages for different purposes, similar to Wikipedia's various Village pumps). Please comment :) --Waldir (talk) 17:04, 3 August 2012 (EDT)
I agree - my talk page is probably not the best place for general wiki discussion, this is better, but best to keep everything together! --Jeff (talk) 20:10, 3 August 2012 (EDT)
I'm importing wikipedia:Template:Village pump to set something like that up. I'll put a working draft in place, feel free to modify as needed, ofc. --Philosopher Let us reason together. 21:24, 3 August 2012 (EDT)

Moved from Talk:Main Page. --Philosopher Let us reason together. 00:46, 4 August 2012 (EDT)

"Random comic?"

Not to clutter the sidebar, but what would you say to adding a "Random comic" right under "Random page", linking to //dynamic.xkcd.com/random/comic/ ? --Philosopher Let us reason together. 01:46, 4 August 2012 (EDT)

Naw, xkcd already has a random comic. I think we should have a random explanation. ;-) All kidding aside, I was wondering: generating a random member of a category...? Has that improved since the early days when I tried to do something like that. -- IronyChef (talk) 03:19, 4 August 2012 (EDT)

Header template

Hi, I've created a template called Template:ComicHeader, which might make things easier when creating comic pages (and also provide better consistency between the pages). I've used it on the Internal monologue page, to display the comic number and the date it was published. The template also adds the page to the Comics category.

You just need to add:

{{ComicHeader|1089|August 1, 2012}}

…to the start of the page (replacing the comic number and date).

I'll try to make the template look a bit nicer, but the great thing about templates of course, is that once they're updated, the changes are reflected on all the pages that include that template. --Yirba (talk) 18:46, 1 August 2012 (EDT)

By the way, I'm thinking of maybe programming something that would allow you to easily import the comic image and alt text from xkcd without having to upload the images manually and the like. You'd just have to host a single PHP file on your server and make a few changes to the MediaWiki configuration. Of course, you'd be able to see source code and everything to make sure I'm not trying to do something fishy. :-P Let me know what you think. :-) --Yirba (talk) 18:54, 1 August 2012 (EDT)
Yirba - I like the idea. My email is [email protected] - send me what you put together and we can sort it out. --Jeff (talk) 19:37, 1 August 2012 (EDT)
Ditto on the Template. Up-vote. Any thought on harvesting the pre-wiki content from ExplainXKCD with some sort of a Python, Perl, or PHP script? (That sounds more like a 'bot than something that would have to be hosted, though.) IronyChef (talk) 01:52, 2 August 2012 (EDT)
I was thinking of putting it into a infobox, please see above. I also intended to automatically extract data from xkcd, which would lack descriptions, but at least we would have data like title, image and transcripts. Also, there are some other data like links (e.g. 832), news (which are displayed in xkcd's header, e.g. 739) and titles which contain HTML (259 and 472). I also extracted all those data. When we agree on a page layout, I could begin programming a bot. --SlashMe (talk) 06:54, 2 August 2012 (EDT)
Hmmm… an infobox may be a good idea. And a bot that imports data from xkcd might be handy. Anyway, here's something I programmed that would allow for access to the xkcd API from the wiki itself. Essentially, you'd put this xkcdinfo.php (source, download) file somewhere on the server (e.g. at http://www.explainxkcd.com/xkcdinfo.php) and include it in MediaWiki's interwiki table (ensuring iw_trans == 1):
INSERT INTO interwiki (iw_prefix, iw_url, iw_local, iw_trans) VALUES ('xkcdinfo', 'http://www.explainxkcd.com/xkcdinfo.php?input=$1', 0, 1);
After enabling scary transclusion in LocalSettings.php, you'd then be able to send queries to the xkcd JSON API via this file. In other words, {{xkcdinfo:32-title}} would make comic 32's title appear. {{xkcdinfo:55-alt}} would make comic 55's image text appear. I've also set it so you could enter {{xkcdinfo:100-embed}}, and it would make the comic 100 image appear on the wiki page. Feel free to use it however you want (if at all), and modify the code should you wish. (Hint: Using the number 0 for the comic number will query the most recent comic, so {{xkcdinfo:0-num}} will return the current comic number. Also, adding "raw:" before "xkcdinfo:" might be more useful in some instances. E.g.: {{raw:xkcdinfo:555-title}})--Yirba (talk) 14:50, 2 August 2012 (EDT)
Nice idea, altough this would mean to load all data from xkcd whenever a page is viewededited (I think this is the way MediaWiki caches the data). This is a lot of traffic for little data. I'd say to include the metadata statically, but linking the external image seems a good thing to me. Again, it'd be great if you gave me feedback for my idea. --SlashMe (talk) 15:54, 2 August 2012 (EDT)
Yes, the data would be loaded from xkcd for each edit. You can, however, substitute (subst) the template for data that is unlikely to change. And therefore the data would indeed be stored statically. I like the layout you've come up with. It could perhaps do with a bit of tweaking here and there, but the general idea is good. --Yirba (talk) 17:16, 2 August 2012 (EDT)
What kind of tweaking do you mean? I know the code is a bit messy, if you have a better idea, please tell me (or do it yourself - hey, it's a wiki!). The CSS should be placed in an external file, but for now, it's ok. --SlashMe (talk) 17:51, 2 August 2012 (EDT)

Looks like there is another/newer template called Template:Comic that includes prev/next buttons as well. You add it with:

{{comic
| number    = 1
| date      = September 30, 2005
| title     = {{PAGENAME}}
| image     = barrel_cropped_(1).jpg
| imagesize = 
| alttext   = Don't we all.
}}

<small>Moved from [[User talk:Jeff]]. --~~~~</small>
==Description==
xxxxxxxxxxx

No need to include the alt text separately, as the template does it for you. It also includes the comic category, but only if the first 4 fields are filled out. --B. P. (talk) 18:47, 3 August 2012 (EDT)

Yes, but that is not necessarily an advantage. My template only creates the infobox, so you are still able to create an introductory text or other sections, for special comics that need a more detailed description. I can also add categories if needed. --SlashMe (talk) 19:02, 3 August 2012 (EDT)
I think it is a major advantage to make the thing easier to use and more consistant site-wide.
As the creator of the new one, I'm obviously biased, but I created it because I think it's better. Not putting your work down, it was a great piece of code that I put to work in my template. But I think if there's need for pre-text of any kind (not sure there is, as the articles probably should all open with the comic itself as presented on XKCD), a pre-comment can be added into the template, but I'm not sure what that would be. Perhaps there would be a requirement for special circumstances like the comic a few weeks ago where there were a million iterations depending on locality, browser, etc. But that's the rarity. I think the new one simplifies it for users. They need only one template to post the comic, alt text title and nav buttons. What could be easier? TheHYPO (talk) 19:08, 3 August 2012 (EDT)
As the creator of the other one, I'm equally biased. What about a "main template", which then calls one or two other templates (e.g. one for the infobox, another for image and alt text? For most comics, this main template could be used, but if absolutely needed, it would still be possible to use the underlying templates with custom sections/text. --SlashMe (talk) 19:15, 3 August 2012 (EDT)
I just now saw your request for feedback on your new comic page with the sidebar. I honestly am not sure which format is better. I kind of like my format for the fact that it basically presents the comic as it was originally posted, but your infobox does provide some additional stuff like 3D link (not sure what "news" is, of where the "link" comes from but...) Perhaps we could integrate the two. I like that the comic is visble right away on my template, but on your page it's down below the first header. I don't think the comic itself needs an "image" heading. No disrespect, but I think your sidebar, esp. because of the "news" field is a bit chunky - too wide for most of its content.
I think we could easily add things like a "3d" link into {{comic}} as part of the next/prev bar where a "3D" field in the template is non-blank. Similarly, original title could read something like (Originally titled: xxxxx) below the primary title in a smaller font. Other than the "link" and "news" fields (which again, I'm not sure what they are), I think that would inclde all the same info as your infobox into my template. Thoughts?
As to your other comment about compartmentalizing the template, I have nothing against that, but which parts of the template would you want to be able to use separately (and can you suggest an example where that might be necessary?) Subdividing the template can always be done later if it becomes needed; just trying to get an idea of what you have in mind by compartmentalizing it. Cheers TheHYPO (talk) 19:43, 3 August 2012 (EDT)

Moved from User talk:Jeff. --Philosopher Let us reason together. 00:37, 4 August 2012 (EDT)

────────────────────────────────────────────────────────────────────────────────────────────────────

Suggestion:

  • I will start by uploading all images. This will take some time and has no points to discuss. (If it has, tell me.) At a later point, maybe we could link them directly from xkcd.com.
  • For the comic pages: Let's say we'll use {{Comic}}. I'll change the arguments of the template to be more like my {{Infobox comic}}, see documentation. I'll keep the alttext argument, but make image optional (file name should be guessed from the title). Do we really need imagesize?
  • {{Comic}} would then call some further templates, passing the appropriate arguments. This way, we are able to use custom sections/text if needed for special comics (like Umwelt) by using these templates instead of the all-in-one {{Comic}}.
  • Since we have one template doing all the work, we can easily change the page layout even after the import. (We should only keep track of the pages that don't use {{Comic}}, using a hidden category)
  • For consistency, I would move all existing pages out of the way and re-create them. The moved pages could be collected by adding them to a category like Category:legacy pages, so they should easily be found. Descriptions should be moved to the new pages, afterwards the legacy pages can be deleted.

This way, I can import all comics, but we would still be able to change the layout afterwards. My 2ct concerning page layout:

  • Use comic titles as page names.(See below) The title should be prominent, the number will be in the infobox.
  • I'll remove Original title, news and link from the infobox and move them to a section after the description. (For details, see here)
  • suggested layout:
=====page title=====
+--------------------+ +---------+
|                    | | infobox |
|       image        | |  text   |
|(no section heading)| |         |
|                    | |         |
|                    | +---------+
+--------------------+
==alt==
text
==description==
text
==transcript==
text
==original title, news and link== (if available)
text

Still open for opinions.--SlashMe (talk) 04:13, 4 August 2012 (EDT)

It might make more sense to use the comic number as the page title, and then use DISPLAYTITLE to make the comic title appear in place of the number. Just putting that out as another possibility. --Yirba (talk) 09:49, 4 August 2012 (EDT)
Good point, I agree. --SlashMe (talk) 09:54, 4 August 2012 (EDT)

If anyone wants to use it, I've written a bot [3] that can upload images, create redirect pages, and create comic pages. You can change the format it uses for the comic page if you have some knowledge of python. To use it, look at [4]. --Cyanfish (talk) 10:56, 4 August 2012 (EDT)

Sorry, I was faster. I'm using mwclient, and I already uploaded all images. I could also create pages and redirects, but I'm waiting until we have a consent. --SlashMe (talk) 11:02, 4 August 2012 (EDT)
A few thoughts: if you start uploading images, but don't create the comic pages with them, a user going to create a new comic page isn't going to know whether or not the comic image has already been uploaded. This could be confusing. Hopefully the uploads are going to be named the same as the original images? (when I do upload, I actually just paste the URL in my "browse" box and upload directly from my browsers cache that way so it works out), but I just want to avoid duplicating images on the server as well as wasting time by trying to upload something that's already there.
As to the page layout, I'm still of the view that the transcript should be in a collapsed frame so that it doesn't take up half the article. I don't honestly think that most people are coming to read the transcript. I could be wrong tho. Open to opinions on that. Otherwise, I do like transcript AFTER The explanation (also, the heading "explanation" vs. "description" as mentioned in another discussion in the portal. TheHYPO (talk) 14:09, 7 August 2012 (UTC)
PS: We definately need imagesize. It defaults to full size, but I think we definately need the optional argument for large comics. Remembering that this is a wiki to explain the comics, there are many large comics that ought to be restricted to a smaller size for the page (they can be clicked to enlarge - the template automatically creates a "click to enlarge" link if imagesize is used). I have generally been using a 375 or 400px size for keeping larger comics managable, but sometimes it's a comic-dependant decision. Also, notwithstanding my comment on another thread, even though I agree that the xkcd commentary is actually "title text", just as a side note, I've just noticed that the transcripts for older comics actually do call it "alt text") TheHYPO (talk) 15:40, 7 August 2012 (UTC)
As long as no one has any objections, this header looks awesome (with ImageSize as TheHYPO suggested), so feel free to work on the importation functionality. Let me know if you need anything from me in order to import from the Wordpress side of things. If we start talking importation, lets move that conversation under a different header. --Jeff (talk) 15:56, 7 August 2012 (UTC)

Summary of current proposals:

Wiki.png
Wiki high res.png
Explain xkcd.png
Explain xkcd2.png
Wiki2.png
Wiki3.png
wiki4.png
Explainxkcd-concept.PNG

The main image (top left of the wiki) is not the best image ever. You really need to update it.

Maybe: Wiki.png

Just an idea, because that text looks weird, or at least please add a transparent background instead of white for the logo (and center the text). --Grep (talk) 21:39, 1 August 2012 (EDT)

I like it. What does everyone else think? (PS - don't forget to sign your entries on this page!) --Jeff (talk) 21:18, 1 August 2012 (EDT)
I could go with that. Had been kicking around some ideas, and if I had any artistic aptitude, it might have looked very much like that: the black-hat retort; alternately: the lowercase blue xkcd that RM uses (sans comic figure watermark) with a "Explain" in a hand-written typeface in some other color splashed across the top left part of those letters. And yes, definitely with transparency. Just thoughts... ultimately, whatever the consensus is... IronyChef (talk) 01:51, 2 August 2012 (EDT)
Something like one of the following?
Wiki2.pngWiki3.pngwiki4.png
--Grep (talk) 12:40, 2 August 2012 (EDT)
I like that first one - File:wiki.png. And perhaps use that same text for the Tagline? --Philosopher Let us reason together. 19:50, 2 August 2012 (EDT)
Yeah, the first one captures what I was thinking. I thought I'd download it to tweak it a bit, and quickly proved to myself how unartistic I am. I was thinking the xkcd pretty much overwhelming the bottom (touching all three sides) and the explain (first typeface) in tight, maybe at a 5 degree angle over the x and k. Of course envisioning it is one thing, realizing it another (it may be totally unrealistic...) but I toss that out for further consideration. -- IronyChef (talk) 00:25, 3 August 2012 (EDT)
Hmmm, rereading Philosopher's comment, I think he and I may have been talking about two different images. Ooops. Anyway, was just chatting with a buddy who is more artistic than I am, and he created this mashup. He suggested: "Establish some vocabulary. First, xkcd needs to be bigger; it defies describing, and refuses to be pidgeon-holed into a box, so the xkcd needs to be so big that it doesn't fit entirely in-frame ... the Explain part has got to be casual, to represent the wiki and informal nature of contributing to it, and you gotta have it in close, because the contributors are going to get as close as they can to the truth. And keep it simple." (I broke with that, and tried to add the black hat; in doing so, I think I trashed transparency, tough) Anybody think that's worth taking a run with it? -- IronyChef (talk) 01:04, 3 August 2012 (EDT)

Explainxkcd-concept.PNG

   y
   o
   u
   '
 w r
ei e
xkcd
piau
l um
a sb
i e
n

Moved from User talk:Jeff. --Philosopher Let us reason together. 00:37, 4 August 2012 (EDT)

I prefer the first option (file:wiki.png). At the size the logo is meant to be, it's perfectly readable; furthermore, it's visually pleasant and it conveys the meaning well. We'll need it to be transparent, and editing the file at the current size produces sub-optimal results. Grep, could you please generate a transparent version of it and reupload it to overwrite the current image? --Waldir (talk) 05:14, 4 August 2012 (EDT)

Slight problem. I don't have the original "it's cause your dumb," I just copied it from explainxkcd.com header, and trying to remove the whitespace myself makes, well, suboptimal results. The font used was Heiti SC/TC, if you or anybody else wants to make it themselves. Also, maybe using #6e7b91 for the XKCD or something... it's the color RM uses on the home page.
I have uploaded a high res version of File:Wiki.png. Not exactly the same, but similar. I used FreeSans and a xkcd font I found at the xkcd forum. I still have the SVG version.--SlashMe (talk) 10:57, 4 August 2012 (EDT)

Explain xkcd.png or Explain xkcd2.png

I suggest the two above this comment. Both of these are designs be me. The first one has a nice xkcd logo-text that features many of the main characters. I personally think that it looks better aesthetically. The second one is a globe that is kind of a nod to wikipedia. The ballon is there because that seems to be an often reappearing theme in xkcd. Now I really need to make a note of this, but xkcd should be in lower case letters unless it begins a sentence. This error exists almost everywhere on this wiki, but we should try to keep it out of the logo (http://xkcd.com/about/ for proof). Also I think that the logos that just say "explain xkcd" are too simple and kind of borring. The use of both black and blue additionally bothers me. Alek2407 (talk) 07:37, 5 August 2012 (EDT)

I agree. I like the first one best, but Megan's hair could be tweaked a little because it doesn't look a lot like her right now. Do you think you could do that? --Waldir (talk) 08:31, 5 August 2012 (EDT)
Explain xkcd revised.png Alek2407 (talk) 06:56, 6 August 2012 (EDT)
That's perfect :D I vote for this one. --Waldir (talk) 07:12, 6 August 2012 (EDT)
By the way: could you make the background transparent instead of white? --Waldir (talk) 07:12, 6 August 2012 (EDT)
 Done We have a winner. Alek2407 - I'll leave a message on your contact page, but please email that logo to me with a transparent background. --Jeff (talk) 15:31, 6 August 2012 (UTC)
Sent. 16:42, 6 August 2012 (UTC)
I've rescaled the image (poorly) and i have asked Alek for a smaller version. --Jeff (talk) 03:25, 7 August 2012 (UTC)
Remember it needs to be transparent as well. Also, I point you again to the suggestions I made below regarding how to properly setup the site logo. Replacing the image server-side is actually recommended against by MediaWiki documentation. --Waldir (talk) 10:51, 7 August 2012 (UTC)
Thanks Waldir, I'm going to have Alek keep it transparent (MS Paint is all I have and it kills transparency... ugh) and when he gets me the final one, I'll change the field and not just replace the wiki.png directly. --Jeff (talk) 12:25, 7 August 2012 (UTC)
+1 for MS Paint :) Brings me good memories... --Waldir (talk) 18:37, 7 August 2012 (UTC)

I've always loved the "It's cause you're dumb" motto of the Explain xkcd blog, which furthermore is (to my knowledge) original to this website, so I strongly recommend a variant of file:wiki.png for the logo. "explain xkcd" (and probably "the wiki" as well) should, I believe, be written with the very same typeface and case (ie full lowercase) than in the header image displayed on top of http://explainxkcd.com. - Cos (talk) 12:31, 6 August 2012 (UTC)

I wasn't sure if Alek was going to do this or not, so I made a transparent copy of the logo and resized it to the optimal 135x135 pixels myself. Here it is (aaaand, another captcha!). Omega TalkContribs 09:50, 8 August 2012 (UTC)

Thanks. I uploaded the image as a new version of File:Logo.png, so when Jeff does the configuration changes, the site logo should be automatically updated. --Waldir (talk) 11:34, 8 August 2012 (UTC)

Displaying Comics

For the home page, I think the comic and explanation should be displayed instead of a link to the comic.

For reasons unknown to me, I decided to create Template:Comicbox and Template:Comicbox2. Looks nice, as long as you use the correct one for the comic.

Go to User:Grep/comicbox and User:Grep/comicbox2 for examples. --Grep (talk) 21:03, 2 August 2012 (EDT)

Those're wonderful! And should probably be on the main page. If you wanted, we could probably incorporate them (and maybe a third?) into a single template with a "square/vertical or horizontal" switch. --Philosopher Let us reason together. 21:36, 2 August 2012 (EDT)
Also, you used "comicbox" for the class. Is that a class that's defined somewhere? (And if so, where?) --Philosopher Let us reason together. 21:36, 2 August 2012 (EDT)
Good point. Removed. And merging them sounds wonderful. --Grep (talk) 21:47, 2 August 2012 (EDT)
Maybe merging them into Template:comicbox? --Grep (talk) 21:49, 2 August 2012 (EDT)
I think classes are defined at MediaWiki:Common.css, so if you really wanted to define the class.... And Template:Comicbox would probably be best. Did you want to merge them or should I take a look at it? --Philosopher Let us reason together. 22:25, 2 August 2012 (EDT)
ParserFunctions and any sort of non-XMLish markup is weird. I would rather you look at it. --Grep (talk) 22:42, 2 August 2012 (EDT)
Okay, I've moved your templates to {{Comicbox square or vertical}} and {{Comicbox horizontal}} so I can work on {{Comicbox}} as the main one. It may take a while - I like to think of myself as a "master of all known wikimarkup," but I don't actually use those skills that often. --Philosopher Let us reason together. 23:08, 2 August 2012 (EDT)
Thanks. --Grep (talk) 23:42, 2 August 2012 (EDT)
I've made it at {{Comicbox}}. This actually leaves {{Comicbox square or vertical}} and {{Comicbox horizontal}} unused, though I credited you (and them) in a comment at the top of the template. --Philosopher Let us reason together. 00:21, 3 August 2012 (EDT)
I think that the explanation should be on the right because it just looks weird as is... --Grep (talk) 07:42, 3 August 2012 (EDT)

──────────────────────────────────────────────────────────────────────────────────────────────────── Sure. But right now they both look like they're on the bottom? --Philosopher Let us reason together. 20:02, 3 August 2012 (EDT)

Sans-serif typeface

I like these, too, but the roman typeface... how do folks feel about sticking with a sans-serif typeface throughout the site? IronyChef (talk) 00:13, 3 August 2012 (EDT)
We should be able to change that wiki-wide through MediaWiki:Common.css, I think. Unfortunately, I don't know enough CSS to do it. --Philosopher Let us reason together. 00:23, 3 August 2012 (EDT)
I believe sans serif is already the default wiki-wide. Those specific instances were deliberately coded to use a serif font. It's just a matter of removing font-family: 'Times New Roman'; from the template. --Waldir (talk) 17:01, 3 August 2012 (EDT)
Oh, I'd missed that. I removed it. --Philosopher Let us reason together. 22:14, 3 August 2012 (EDT)

Moved from User talk:Jeff. --Philosopher Let us reason together. 00:37, 4 August 2012 (EDT)

comic header

Jeff, further to your previous conversation on the comic header, I've significantly rewritten Yirba's template (thanks to Yirba for the hard work. His navigation bar was very useful) and I've created a new template of {{comic}}. An example of the comic in use can be seen at T-shirts. I started a discussion on the main page discussion board, but I thought if I pointed it out to you and you like it, it can start going in the rotation for new comics.

I actually now see that Grep did a template up with intent (I think) to use for the main page. Had I known that when I started, I would have probably based my template off of his, because it looks nice, but either way, mine is intended for the actual articles. TheHYPO (talk) 14:46, 3 August 2012 (EDT)

Again, may I link to my request for feedback? --SlashMe (talk) 15:52, 3 August 2012 (EDT)

The discussion is now at Explain XKCD:Community_portal/Design#Header template. --SlashMe (talk) 04:17, 4 August 2012 (EDT)

Moved from User talk:Jeff. --Philosopher Let us reason together. 00:37, 4 August 2012 (EDT)

Template improvement suggestion

Can I suggest that we work on improving {{ComicHeader}} - I wish I had time to do it myself and then edit all the comic pages, but I would suggest the best way might be to start a new template (perhaps design it a bit more like an infobox) and start converting the old pages over to new ones.

The feature I think should be added is that, where the template currently includes teh comic number and date, and creates the nav header, the template really ought to include the image name, and the alt text. In that way, the template can produce the entire part of the article that displays the comic and its alt text (and the alt text, as mentioned, could be more like a caption, instead of just looking like a generic section of the article - it's part of the comic, it shouldn't look like part of the article on this site (no offence, Jeff, but that's one thing I always didn't like about explain XKCD - the image text should be bold or underlined or italics or something to signify that it's part of the comic and not the explanation.

I'll see if I can work on a prototype. TheHYPO (talk) 12:29, 3 August 2012 (EDT)

What does everyone thing of this as a better layout? Blown Apart TheHYPO (talk) 13:09, 3 August 2012 (EDT)
May I link to my request for feedback? --SlashMe (talk) 15:52, 3 August 2012 (EDT)

Moved from Talk:Main Page. --Philosopher Let us reason together. 00:44, 4 August 2012 (EDT)

The discussion is now at #Header template. --SlashMe (talk) 04:17, 4 August 2012 (EDT)

Transcripts

Do we need to add a whole section on "Transcript" for each comic? That could get very long for some comics, and basically pushes the explanations down further (which is what people generally come to explainxkcd for). If anything, perhaps the transcripts could be in a minimizable box like some navboxes do on wikipedia? I don't see a majority of users coming to read the transcripts... TheHYPO (talk) 19:15, 3 August 2012 (EDT)

What about putting the transcripts at the bottom of the page?
BTW: If you agree, this discussion should be moved to Explain XKCD:Community portal, as Waldir suggested. At least for new discussions. --SlashMe (talk) 19:19, 3 August 2012 (EDT)
No problem there. Feel free to move it. TheHYPO (talk) 19:29, 3 August 2012 (EDT)

Moved from Talk:Main Page. --Philosopher Let us reason together. 00:47, 4 August 2012 (EDT)

The discussion is now at #Header template. --SlashMe (talk) 04:18, 4 August 2012 (EDT)

Adding a new comic

This is the process I use to add a new comic. YMMV... Feel free to update this as/if needed to provide some consistency...--B. P. (talk) 19:22, 3 August 2012 (EDT)

I start by uploading the image using the name from XKCD's page.

I create the new page using the comic number(not the name), e.g. "http://www.explainxkcd.com/wiki/index.php?title=1"

I (currently) insert using the "Comic" template:

{{comic
| number    = 1
| date      = September 30, 2005
| title     = {{PAGENAME}}
| image     = barrel_cropped_(1).jpg
| imagesize = 
| alttext   = Don't we all.
}}
==Transcript==
This is the transcript from xkcd
==Description==
Wow what a cool comic!

I "Show preview" to ensure the image shows up and everything looks good.

I "Save page".

I click the "move" link on the down-arrow drop-down menu to the right of "View history" (at top of page).

I rename the page from "1" to the page title from XKCD.

This will automatically create a redirect from "1" to the correct page name without having to do it manually. --B. P. (talk) 19:22, 3 August 2012 (EDT)

Please, have a break here. When we agree on a page layout, I can do this automatically. I repeat, when we agree on the layout (which should also include the direction of the redirects) --SlashMe (talk) 19:25, 3 August 2012 (EDT)

Moved from Talk:Main Page. --Philosopher Let us reason together. 00:47, 4 August 2012 (EDT)

The discussion concerning the layout is at Explain XKCD:Community_portal/Design#Header template. --SlashMe (talk) 04:18, 4 August 2012 (EDT)

styling of xkcd links

I added code to the end of MediaWiki:Common.css to style links to the xkcd website as http://xkcd.com rather than the regular external link format, http://example.com. What do you guys think? --Waldir (talk) 05:06, 4 August 2012 (EDT)

I like it generally. Is there a way to force it to not display on individual pages, though? I don't think we should have it at Explain XKCD:Copyrights, {{XKCD file}}, or {{XKCD file derived}}, as they are more serious. --Philosopher Let us reason together. 16:27, 4 August 2012 (EDT)
Sure. I've disabled it on those pages, feel free to add more as you see fit. --Waldir (talk) 17:22, 4 August 2012 (EDT)
Thanks! --Philosopher Let us reason together. 18:34, 4 August 2012 (EDT)
I like the idea of the graphic, too, but wonder if it could be muted a bit (medium gray vs black) so it recedes a bit into the background; the classic graphic is a very light blue for that reason, too. (Oh, and a minor quibble... overheard: "who is that short, bearded dude?" "Oh! That's megan?") ... I don't know how we could update it, and maybe it'll be less of an issue when muted... Thotz? -- IronyChef (talk) 14:16, 7 August 2012 (UTC)
The image can be updated by uploading new versions of xkcd favicon.png. It doesn't need to be the xkcd.com favicon; in fact, it would be good if we could make it even smaller (e.g. just cueball's head, or simply "xkcd" in the typical handwritten font, etc). Making it dimmer also seems like a good idea, btw. --Waldir (talk) 19:38, 7 August 2012 (UTC)

'Explanation' rather than 'Description'

Can I suggest we use the heading "Explanation" rather than "Description" on the comic pages, since that fits with the name of the wiki? --SurturZ (talk) 09:20, 5 August 2012 (EDT)

Agreed. --Waldir (talk) 14:27, 5 August 2012 (EDT)
Seconded TheHYPO (talk) 14:04, 7 August 2012 (UTC)

Naming conventions

Wanted to start a discussion here on naming conventions, and two items come to mind:

  1. The name of Randall's site: XKCD or xkcd or Xkcd? I noticed that there, it's always written lowercase, when shown in uppercase, it's because it's in a small-caps or all-caps typeface. Should we follow suit?
  2. What is the name of this site? Explain XKCD, or ... ? Ultimately, I think this is Jeff's call, but I'm guessing the outcome may hinge on how we address the first question.

Should we normalize the references here to some convention, or leave the matter alone? I know that personally, I've always been writing lowercase xkcd, and usually using {{xkcd}} to link to the site (as in xkcd ) to maximize links back to the site. Thotz? == IronyChef (talk) 22:08, 5 August 2012 (EDT)

For 1, I think there is no discussion needed, Randall makes this clear here: How do I write "xkcd"?. I already started changing some of the instances of all caps XKCD into lowercase xkcd on the wiki, but there are some places (such as in the logo, in the Explain XKCD namespace name, etc) that will require server access to fix. --Waldir (talk) 05:16, 6 August 2012 (EDT)
Regarding 2, I was wondering the same when I started lowercasing xkcd. "Explain XKCD" makes more sense when xkcd is capitalized, but it looks a little weird IMO as "Explain xkcd". Maybe "explainxkcd"? "explain xkcd"? Or just ignore the initial strangeness and stay with "Explain xkcd"? --Waldir (talk) 05:16, 6 August 2012 (EDT)
I'm 100% with the lowercase conversion of XKCD everywhere, per Randall's explanation (indicated by Waldir). Places where something needs to be done:
Cos (talk) 12:19, 6 August 2012 (UTC)
Just to give credit where it's due, it was Alek2407 who first raised this problem, above :)
That said, for the namespace change it would be trickier for any of the other default namespaces, but the project namespace can be easily configured by setting $wgMetaNamespace = "Explain xkcd"; in LocalSettings.php. The sitename can likewise be changed by changing, as you mentioned yourself, $wgSitename. It seems there is a consensus so I'll warn Jeff to take a look at that.
The logo definition should be changed from $wgLogo = "$wgStylePath/common/images/wiki.png"; to $wgLogo = "$wgUploadPath/c/c9/Logo.png". I've uploaded the current logo to File:Logo.png (note: even though it is saved with a png extension at http://www.explainxkcd.com/wiki/skins/common/images/wiki.png, it was actually a jpg file!), and protected the image, so afterwards when we decide on a logo (and should we ever need to make adjustments to it), we can simply upload a new version of that file without needing Jeff to change things server-side. I'll also ask Jeff to perform this change. --Waldir (talk) 15:15, 6 August 2012 (UTC)
This is all phenomenal. I'm down with "explain xkcd". I'll perform the server-side changes tonight. --Jeff (talk) 15:44, 6 August 2012 (UTC)
Also, looks like you found out my leet jpg -> png converter aka renaming the file extension! --Jeff (talk) 15:48, 6 August 2012 (UTC)
Emoticon tongue.png --Waldir (talk) 16:57, 6 August 2012 (UTC)

Comments

moved to Explain XKCD:Community portal/Technical#Comments --Waldir (talk) 17:10, 6 August 2012 (UTC)

Automation

moved to Explain XKCD:Community portal/Technical#Automation

References

moved to Explain XKCD:Community portal/Technical#References

Allow external inline images

Hi. I'd like to propose that we set $wgAllowExternalImages to true or add xkcd.com and some image hosting sites (such as imgur.com) to $wgAllowExternalImagesFrom. If the former is set to true, external images will be allowed from any host, whereas if the former is kept as false but we add some sites to the latter (obviously adding xkcd's site itself seems to be the logical choice), then only images that are from whitelisted sites can appear as inline images. What this does is it allows external images to be displayed as an actual image, rather than just a link (note that sites not in the whitelist will still appear as just the link). Why? Because there's no way to display images without uploading them. Obviously some editors may wish to use images for non-wiki purposes, such as proposing alternative logos or for their userspace, in which case uploading the images to this site isn't entirely practical. Allowing externally hosted images to be displayed will alleviate that problem.

Yes, there is the risk of... less appropriate images being displayed, however, I consider that being a null argument, as editors could just as easily upload the image here and link it as an internal image. As well, using the whitelist alternative would limit the image to being posted from a trusted site, such as imgur. Finally, if worries about nude photos being posted is really a concern (seriously, what's stopping an editor from just uploading said image here? Nothing.), it's possible to only whitelist sites which don't permit nude images from being hosted on their site (such as imageshack.us), although I think that's a bit extreme (especially considering that imgur is hands down the most popular image host these days). Omega TalkContribs 07:52, 8 August 2012 (UTC)

I really don't see a compelling reason to have this. It's not about improper images or anything. (Note that we already have access to all images in Wikimedia Commons, by the way, which has a large variety of images and other media, with the added benefit that we're sure they can be reused without licensing concerns). A specific whitelist could be interesting (e.g. we could hotlink the images from xkcd), but having the images here allows us to do neat things like categorizing them by topic, size, etc. Also, images like logo proposals, etc. do benefit from being uploaded here (for historical interest, for a guarantee that they won't be deleted wherever they're hosted, for better control regarding how they're displayed, etc.) --Waldir (talk) 19:27, 8 August 2012 (UTC)

Latest comic handling

Currently the latest comic is handled automatically by the {{LATESTCOMIC}} template, which tests the existence of pages like 1092, 1093 (supposed to be redirects to the corresponding comics), to see which is the highest-number existing page, and consider it the latest comic.

That way we can have the latest comic automatically transcluded on the main page.

But we cannot have, with that system, an automatic "Edit" link (to edit the latest comic) on the main page, nor can we have automatically the comments associated with that latest comic. The former was changed to a "Go to this comic" link, and the latter was removed. I think both of them are really useful things to have on the main page.

I've been thinking a little bit about this, and in the end I suggest that we handle manually the latest comic :

  • There would be a single {{latest comic}} template, which would have to be updated manually to return the full title of the latest comic's page (such as "1092: Michael Phelps").
  • Next to the "Latest comic" header, on the front page, would be appended a "[update]" link, to a page explaining that to insert the new latest comic in the wiki: one needs to 1/ create a page titled "<number>: <title>" and 2/ update the {{latest comic}} template with the new title.
  • The "Edit this explanation" link could be put back on the main page, using something like [{{fullurl:{{latest comic}}|action=edit}} '''Edit this explanation''']. And I firmly believe that link is important. (*this* for instance is exactly what I'm talking about)
  • The comments to the latest comic could be appended under the latest comic's transclusion, with something like {{ {{TALKPAGENAME: {{latest comic}} }} }}. They could be in a collapsible area if they take too much space. Same here than about the edit link, I believe that's really important to impel/motivate readers to leave their comments as well.
  • Finally, when only the number is needed (such as in the computation of the number of missing explanations), this could be done via another template (for instance {{latest comic number}}), automatic this time, which would replace the current {{LATESTCOMIC}} by extracting the value out of {{latest comic}} (with something like {{#explode:{{latest comic}}|:}}).

So, yes there would be a value to update manually, but that's not really much and if it's part of a process I don't think that would be a big drawback, and on the other hand I think it would be less error-prone than an automatic calculation, and allow more useful things. And make less use of redirects as well. Furthermore, the current {{LATESTCOMIC}}, used quite a lot (in the sidebar, so in every page actually), makes heavy use of the {{#ifexist:...}} parser function, qualified as "expensive", so even though it may not be a big deal it could be a better option to try to avoid that...

What do you think?

Cos (talk) 16:53, 8 August 2012 (UTC)

A few considerations:
  • We can instead add the edit link directly to the comic page. It could be generated by the {{comic}} template, which already has to be provided with both the number and the title of the comic (in fact those could even be automatically extracted from the page title with some string parsing functions or clever templates). This should solve the "edit this comic" link issue.
  • Actually, the discussion part was hidden from the main page on purpose (although for a different reason: it was transcluding the main page's own talk page instead). I am not sure it's a good idea to include it in the main page as it could clutter it, but I can understand the point of putting it there. I would suggest perhaps including it directly rather than inside the {{comic discussion}} box, as that would create a box on a box layout that I don't think would look too good. Note that there is no problem with needing the pagename here, since we can transclude a redirect (the same way the actual comic page is transcluded using only the number, which is a redirect).
  • I did see that edit and was thinking that we could probably display a custom info message whenever someone attempts to edit main page, so they'll know they can edit the actual comic page. I'll add that to my todo list.
  • Mediawiki itself will tell us when a potentially expensive parser function is being used too much, by placing the corresponding page in Category:Pages with too many expensive parser function calls. So we don't need to be concerned with premature optimization :)
--Waldir (talk) 19:16, 8 August 2012 (UTC)

How to reference strips?

I think we need to agree on a citation style for strips in plain prose. I.e. If the Black Hat article says "Black Hat first appears in ________", how are we filling that blank? In this case, the blank is 29: Hitler. As I understand it, proper style for an "episode" name typically is quotes, so the stip is "Hitler". But there's still various options:

  1. "Hitler" [quotes not linked]
  2. "Hitler" [quotes linked]
  3. Comic #29
  4. #29
  5. 29: Hitler
  6. "Hitler" (29)
  7. "Hitler" (#29)
etc.

Anyone have any opinions?