Talk:Main Page

From WikEmacs
Jump to navigation Jump to search

IMPORTANT: Offline discussion

There is a Google group for discussion of the site: https://groups.google.com/forum/?fromgroups#!forum/wikemacs so we should probably favor posting there. PhilHudson 16:16, 26 March 2012 (EEST)

IMPORTANT: Content Quality guidelines

I think before flame wars and fights among members, we should form proper/strict guide lines for each aspect of the site. DePuy Pinnacle Lawsuit Wikipedia has very strict rules about that., even their bots can tell the content quality of a page. we can create articles in "WikEmacs" Namespace. Kindahero 23:57, 1 April 2012 (EEST)

Wikipedia has lots of rules today, but it started with very few rules and they invented the rules as they became necessary. It's impossible to predict what problems will be encountered. I'd suggest that rules only be made when it becomes clear that one is necessary. Ciaran 15:24, 29 January 2013 (EET)

Structure

I would like to structure the Main Page in boxes like here [1] the Featured Article/Project. Any objections? And maybe User:Bozhidar should write some lines about the relation to the "old" EmacsWiki?--Kenda 19:58, 24 March 2012 (EET)

This seems like a good idea. Might help us utilize better the screen estate. As for the relation to the EmacsWiki - it is more or less non-existing. We have the permission from Alex (kensanata) to migrate any content we choose to, but they won't be supporting us in any way. Bozhidar 20:28, 26 March 2012 (EEST)

Markup Conventions

Wikipedia linking convention

Could/should we have a convention for formatting and placement of wikipedia links on pages? PhilHudson 22:37, 24 March 2012 (EET)

EmacsWiki linking convention

Similar question to Wikipedia wrt EmacsWiki PhilHudson 23:06, 24 March 2012 (EET)

Describing Modes and Packages

Naming Conventions

I'd like to suggest *not* suffixing (links to) modes with "-mode". Thus: "org" not "org-mode". For consistency I've been adding links titled "org-mode" until now, since that one was already created when I started. PhilHudson 22:09, 24 March 2012 (EET)

Agreed, let's use the "friendly" name of a package. I'd say "Org", "Gnus", "YASnippet", etc. GregLucas
I actually disagree. E.g. Java could be a page describing the different Java capabilities of Emacs, with links to the different JavaScript modes. This is especially true for JavaScript, where the js-mode shipped with the latest Emacs is completely different from the other widely used js2-mode by Yegge. Damd 18:20, 25 March 2012 (EEST)
Hm, good point about disambiguation... I still like the idea of using "titles" vs "commands", though. E.g. a Java page describing the built-in support (Java Mode) and then linking to articles on related packages (JDEE, etc) and why you might consider them instead. GregLucas 19:32, 25 March 2012 (EEST)
How would we handle e.g. Haskell? Emacs doesn't ship with any Haskell mode as far as I know... damd 19:58, 25 March 2012 (EEST)
Not ship, but a haskell-mode definitely exists and is in use...--84.192.109.230 18:33, 11 January 2013 (EET)

Template for mode-with-github-source pages?

Can Wikimedia do page templates? I'm sure the answer is yes. PhilHudson 23:07, 24 March 2012 (EET)

Issues

Syntax highlighting

Could we install a MediaWiki plugin which lets us do proper syntax highlighting of different languages? SyntaxHighlight GeSHi looks like a good alternative. damd 20:07, 25 March 2012 (EEST)

I've already installed it, but it doesn't seem to work properly (the fonts seem terribly small) and it doesn't support Emacs Lisp. Bozhidar 20:24, 26 March 2012 (EEST)
Are you sure the font size is not because of your web browser settings? They look just fine when I try it. About the Elisp support, we can still use just "lisp" until someone gets around to writing a version for Elisp. damd 18:44, 31 March 2012 (EEST)
I also found font size in the code snippets are inconveniently low. I dont have any special settings for my browser. I am on recent firefox. Kindahero 18:52, 31 March 2012 (EEST)
We could customize the CSS for the syntax highlighting plugin, but first let's make sure it's actually something in the CSS that causes this.
This is just an ordinary PRE element.
This is a PRE element generated by the syntax highlighting plugin.
Is the font in both examples too tiny? If so, I suggest you check your browser settings. You can configure this in the "Content" section of Firefox's settings. damd 19:13, 1 April 2012 (EEST)
I only find the second one small not the both. I started with 'firefox -safe-mode' still the same. It seems its general problem with Geshi see http://stackoverflow.com/questions/5354968/changing-the-font-size-of-code-formatted-by-syntaxhighlight-geshi-in-mediawiki Kindahero 20:25, 1 April 2012 (EEST)

fails to create thumbnails

I think some adminstative settings must be made in order to produce thumbnails of the pictures automatically. Can anyone do this .? check out Dictem to see what I am talking about. Kindahero 16:21, 31 March 2012 (EEST)

found this link, http://www.mediawiki.org/wiki/Manual:Configuration_settings#Thumbnail_settings Kindahero 16:24, 31 March 2012 (EEST)
another link, http://www.mwusers.com/forums/showthread.php?1334-Resized-thumbnail-images-not-displaying Feel free to delete these links Kindahero 16:28, 31 March 2012 (EEST)
I see that on [[File:Screenshot-dictem-buffer.jpg]], the main image is not displayed. The "Full resolution" link shows a valid image. By the way, this type of question might be appropriate for Google Groups:WikEmacs. Xophist 21:31, 1 April 2012 (EEST)

needed plugins

I had this problem when getting Cite_web set up on en.swpat.org. If I look into how I got it working, could it be fixed here too? Ciaran 15:31, 29 January 2013 (EET)

Closing down? But I just got here!

I just saw the Slashdot story about WikiEmacs closing down. Pity. A MediaWiki wiki about Emacs sounds great. I find MediaWiki sites much easier to navigate and I think they're easier to maintain/organise.

Maybe WikiEmacs' problem was just that it never got publicity? Ciaran 15:21, 29 January 2013 (EET)

I fully agree with Ciaran. I too am a newcomer. There are probably many more like me who would be willing to help out if only they knew this site existed. This wiki needs better publicity and cheerleading. We should have special event drives for porting and properly formatting content from the old Emacs wiki, in addition to ones promoting original article creation. A community needs to be established and articles need to be written. One way to get the word out is to contact administrators of various major Emacs projects and ask that they start an article on their project and add a link to WikEmacs in their helpful links section. If they do not want to help, no problem. However, I think many would, and it would let them know about the site's existence as a bonus so word of mouth would start to spread.
I find the style used on the old Emacs wiki to be horrendous to say the least. Is it an unstructured discussion forum? A knowledgebase of all things Emacs? A tips and tricks guide to hacking functionality that should be built into Emacs? Changing the tide of confusion on that site would likely be more trouble than it is worth. A new wiki is needed. I myself pledge to port over one article from the old Emacs wiki a week if that means this site will stay online. --Holocronweaver 17:37, 3 February 2013 (EET)
Take a look at this: BackwardKillLine on emacswiki. If just reading this article does not inspire you to to keep WikEmacs open, nothing will I'm afraid. --Holocronweaver 22:30, 22 February 2013 (EET)

WikEmacs staying open? Great!

Glad to hear it's not closing. Anything we (new contributors) should know? Is anything changing? Ciaran (talk) 09:51, 20 April 2013 (EDT)

Hello, I am the new caretaker of WikEmacs. No major changes have been made. This will continue to be a site by and for the users, so I welcome all input for suggested changes. As the site expands and users return, we will likely need to revisit the control structure and possibly modify the site rules. For now I would like to focus on growing the wiki. --Holocronweaver (talk) 15:09, 22 April 2013 (EDT)

Keeping the licence situation clear and clean

Just noting the current situation...

  • emacswiki.org is published under multiple licences, including GPLv2, GFDL (no version specified), CC-sa, and their own simple permissive licence.
  • The GNU Emacs manual is published under GFDLv1.3+
  • Existing WikEmacs texts are under GFDLv1.3+

For emacswiki.org, we could either ask them to specify their version(s) of GFDL, or we could use their text under their simple permissive licence. If we do the latter, we could include a mention of their copyright notice either in the default copyright notice at the bottom of all WikEmacs pages, or we could create a template "This page includes text from emacswiki.org, used under this licence".

For the GNU Emacs manual, if we're going to continue using GFDLv1.3+, then we don't have to do anything. But if we want to switch to the dual-licence model used by Wikipedia (and accepted by Stallman), then whenever we copy text from the manual, we'd have to put a template on those pages to say that those pages are only available under GFDLv1.3+ (and not CC-sa).

For text by WikEmacs contributors, we could continue to license it under GFDLv1.3+, or we could say that from now on, contributions are under the Wikipedia-style dual-licence (GFDLv1.3+ and CC-sa). This wouldn't change much but it would give us more options in the future if we do encounter problems.

I'll have to think for a while before having any recommendations, and there's currently nothing messy or problematic, but just wanted to note the situation early on in case anyone wants to make suggestions. I have experience with licensing issues. Ciaran (talk) 07:02, 23 April 2013 (EDT)

I have spent some time thinking on this, and your suggestion of asking emacswiki.org to clarify their version of GFDL appears to be simplest. That way WikEmacs could maintain its current GFDLv1.3+ license and no ugly licensing notices would be necessary when porting content from emacswiki.org, assuming thes choose GFDLv1.3+. In the event they choose a different version of GFDL, is it possible to port old versions of the license to new versions so we could use the material under GFDL1.3+? --Holocronweaver (talk) 13:30, 3 May 2013 (EDT)

Which emacswiki.org topics to work on?

So, for each of the useful pages on emacswiki.org, we should make our own pages for those topics and incorporate the knowledge that's in the emacswiki.org pages, but how do we make a list of the useful emacswiki.org pages?

Does the site have any equivalents to MediaWiki's pages:

? (But IMO we should take a decision on the licence before doing a lot of work.) Ciaran (talk) 12:27, 24 April 2013 (EDT)