Difference between revisions of "Talk:Main Page"

From PyMOLWiki
Jump to navigation Jump to search
(cmd commands)
(27 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 
== New ==
 
== New ==
 +
* Due to wiki code (or my inability) I couldn't get images to float left/right in the table w/o it looking really ugly.  So, if someone can get say the Colorama example to float right and look good, please do.
  
=== Some Thoughts For Discussion ===
+
* Let me know if you like the updates to the main page.  I like it because it utilizes more of the screen real estate.  Thus, no scrolling (for me).  If you can clean it up, and make it prettier, feel free. [[User:Inchoate|Tree]] 17:08, 9 December 2007 (CST)
* Would it be helpful to get rid of display of the somewhat awkward "Cmd" prefix for commands, and simply do a better job of separating the sections that cover concepts and ideas from those that discuss specific commands? 
 
  
* Empty links discourageCould we eliminate them sooner rather than later? Yes, they are helpful initially for maintaining some structure, but people do get bummed out when they follow a link for an interesting topic and end up with nothingIf there are too many of these, then they may quit and go home before finding the real content -- and that would be a shame since there is now plenty of real content.
+
*So, I found out, finally, why it's been hard to find thingsCategory pages aren't scanned for keywords for searching. So, we'll need to move our category pages' text to new pages and make the linksFor example, searching for "mencoder" didn't work before today.  Since I moved <nowiki>[[:Category:Software_Movies]]</nowiki> to '''Making_Movies''' we can now search for the keywords in that page.
  
* For those coming into the Wiki for the first time, we should insure that the most useful content is out front and on top. Right now the TOC has an awful lot of blank links, so having it on top isn't so helpful as a starting point for nagivation.  In contrast, the Categories, Script Library, and PyMOL Commands sections all seem like pretty good starting points.
+
*Well, one idiot/spammer made it through the new system. If there's an influx of the idiots, we may go back to the old registration method, as that seemed pretty secure.
  
* For people (like me) who don't know the first thing about Wiki's, more "newbies click here to learn" links would help ease the transition...
+
* Feature Request: Support for 3D DLP and plasma HDTVs. These require a different stereo output format (checkerboard.) Feel free to contact me for details. --[[User:Martyholloway|Martyholloway]] 17:46, 30 May 2008 (CDT)
  
* Categories & subcategories confuse meThe resulting titles baffleFor example, '''Category: Using Pymol Objects and Selections Working with Objects'''Shouldn't there be another colon in there? '''Category: Using Pymol Objects and Selections: Working with Objects'''  Is this just a Wiki thing?
+
== Some Thoughts For Discussion ==
 +
* Folks, please check out the section [http://www.mediawiki.org/wiki/Help:Images#Gallery_of_images MediaWiki Image Galleries] for cleaning up the code for inserting more than one imageThis fixes the problem of having to insert tons of blank lines to cleanly offset the following textSo, if you have some time, please head back to old pages and help clean this up.
  
[[User:Warren|Warren]] (BTW: Please don't weight what I write too heavily hereWith respect to PyMolWiki, I am just another user -- and a clueless one at that).
+
* We need to accurately document settings for PyMolThis would greatly improve the value of the siteWe should also provide images and examples.
----
 
=====Begin Inchoate's Comments To Warren=====
 
First off, thanks for the postI always welcome better ways to work and organize information.  I don't claim to know any more than anyone else, I just took the initiative for PyMolWiki.
 
  
Warren, you're completely right.  Something needs to change, to make this more usable for people.  I tried to organize the PyMol information via the user manual and user comments.  Imposing a hierarchy on a system that doesn't really want one, isn't such a good idea, or my imposition was implemented incorrectly.  The link names need to be MUCH shorter: take a look at http://wikipedia.org.  They have 500,000+ pages and they have short link names. I tried to make a hierarchy so that if three such people come in and look up "rotate" that they go to the right page.  That is, there's "rotate," "cmd.rotate," and camera independent rotations and whatnot. We have name ambiguitities. Do we just make one big page with "rotate" and include all its information there, or do we make "rotate" a category and dole out the pages to the category?
+
* For people (like me) who don't know the first thing about Wiki's, more "newbies click here to learn" links would help ease the transition...
  
I'm ambivalent towards empty links.  They remind me of what basic concepts that need filling, but are annoying if you're searching for info. and there's nothing there.
 
  
As far as the comments on categories and subcategories, as I understand it, you can't use double ":"s in names. You have categories and then something is made a subcategory by claiming that is'a  category of a categoryKinda' strange.
+
==Where is the anti-spam mechanism/strategy?==
 +
Manual removing spam contents really sucks.
 +
----
 +
Edit by AdShea
 +
One good strategy is to search all namespaces for 'http' (without the quotes)This will show links containing that string, which should catch any spam links.
  
I do think organization is good.  My way was seemingly obfuscated.  Don't you think PyMol commands should somehow be lumped into available categories?
+
== Needed Editing ==
Changes to be made from my POV:
 
* Much shorter link names
 
* Kill the hierarchy?
 
* How to use the Wiki Intro
 
  
======Part 2======
+
Needed edits are the following:
I tihnk I found the problem, and I might be able to solve it.  I just made things hard by including the hierarchy <u>in</u> the naming scheme, when that's not appropriate.  I think the hierarchy's still very important; however, I think the name-ambiguity problem is not solved via this method.
 
  
======Part 3======
+
# We need more thorough "See Also" sections on each page[[Mesh]] shows what each page should look like.  People need to be able to find their content easily.
I've made lots of changes:
+
## After some playing with this, I think we should create categories for each SET of settingsLike, "surface_settings" and then just put all the surface settings in there.  Then, we can simply link out to this page and it'll change dynamically with the settings.
* I actually took Warren's suggestion on epmty linksI sifted through the TOPTOC and made empty links normal text -- but left them there in case anyone wants to make them links by adding content.
+
# We need to continue linking categories to their respective pages.
* Also, I've gone through all the commands and removed the Cmd prefixThe commands, and all commands buried in modules should be easy to create by simply making a new page as, for example, "Editing.Get_Dihedral" or whatever.
+
# More images should be uploaded for the settings changes so people can ''see'' what the settings do as well as read how to control them.
* The names of the links should be MUCH easier to handle, and are far less obfuscated.
 
  
MediaWiki-style organization is starting to make sense.  :-)
+
== Searching ==
  
[[User:Inchoate|Inchoate]] 00:48, 6 May 2005 (CDT)
+
The default method for searching, eg hitting ENTER, should be the "Search" command not the "Go" command.
----
 
  
=====A singular vote from TStout=====
+
== New Format ==
 +
Code for the new page
  
One thing that I think has been missing from the manuals and the Wiki (and manuals for many other programs, I might add) are copious EXAMPLES of how to actually use a command.  Speaking as an advanced-dummy, I find it terribly imposing to be presented with something like '''"cmd.select(string name, string selection)"''' as an explanation for how a command works.  "How does that translate into what I should type?" is the polite version of how I end up reading such things....  :)  Recently, I have noticed more "real" examples being entered into the Wiki: THANK YOU!  The example given just now also comes complete with an Examples entry with things like:
 
              select near , (ll expand 8)
 
              select near , (ll expand 8)
 
              select bb, (name ca,n,c,o )
 
For beginning users, such entries are invaluable.  In fact, I would extend that to say that an inverted approach to manual/Wiki writing would be even better for the beginning PyMOL user: organize around how to accomplish the usual tasks, not around a glossary of all the possible commands......That said, a HUGE thank you to all who are putting in so much time building, maintaining and getting this to critical mass so that it becomes the invaluable resource it clearly is headed toward!  -Tom
 
  
----
+
__NOTOC__
  
=====Where is the anti-spam mechanism/strategy?=====
+
{| align="center" style="padding-bottom: 4em;"
Manual removing spam contents really sucks.
+
|+ style="font-size:210%; font-weight: bold; color:#032d45; text-align:center; padding: 5px; margin-bottom: 7px" | Welcome to the PyMOL Wiki!
----
+
|- style="text-align:center; font-weight:bold; color: #6d6003; font-size: 140%; font-style: italic; font-family: serif;"
 +
| The community-run support site for the [http://pymol.org PyMOL] molecular viewer.
 +
|}
  
== cmd commands ==
+
{| align="center" width="45%" style="background: #EDEBD5; margin-bottom: 4em; border-bottom: 1px solid #AFB29E; border-left: 1px solid #AFB29E; border-right: 1px solid #AFB29E;"
 +
|+ style="font-size: 1.4em; font-weight: bold; color: #032d45; text-align:center; background: #5F7F96; padding-top:0.5em; padding-bottom: 0.25em; border-top: 2px solid #AFB29E; border-bottom: 1px solid #fff;" |Quick Links
 +
|-
 +
| style="font-size: 1.1em; color #61021F; padding: 0.5em 1em 0.5em 3em;"|'''[[:Category:Tutorials|Tutorials]]''' || '''[[TOPTOC|Table of Contents]]''' || '''[[:Category:Commands|Commands]]'''
 +
|-
 +
| style="font-size: 1.1em; color #61021F; padding: 0.5em 1em 0.5em 3em;"|'''[[:Category:Script_Library|Script Library]]''' || '''[[:Category:Plugins|Plugins]]''' || '''[[:Category:FAQ|FAQ]]'''
 +
|-
 +
| style="font-size: 1.1em; color #61021F; padding: 0.5em 1em 0.5em 3em;"|'''[[Gallery]]''' | '''[[Covers]]'''
 +
||'''[[CheatSheet|PyMOL Cheat Sheet]]''' (''[[Media:PymolRef.pdf|PDF]]'')
 +
||'''[[GoogleSearch]]'''
 +
|}
  
Hi Inchoate
 
  
I tried to change the "cmd delete" command into "delete", I moved the page but I couldn't figure out how to change the command name in the command list page...
+
{| width="100%"
Any help is welcome! I'm a newbie with Wiki...
+
| style="vertical-align: top; width: 40%" |
Cheers
+
{| class="jtable" style="float: left; width: 90%;"
 +
|+ style="font-size: 1.4em; font-weight: bold; text-align:left; border-bottom: 2px solid #6678b1;" | News &amp; Updates
 +
|-
 +
! Warren
 +
| News about Warren DeLano's passing may be read on [[Warren|Warren's memorial page]].
 +
|-
 +
! PyMOLWiki
 +
| Reformatted Main Page.
 +
|-
 +
! PyMOLWiki
 +
| New &mdash; Search the PyMOLWiki via [[GoogleSearch]]
 +
|-
 +
! PyMOL
 +
| PyMOL is known to work under Mac OS X 10+ (Snow Leopard) using the new Fink and incentive builds.  See [[MAC_Install#PyMOL_Install_from_Source.2C_Using_Fink|Installing PyMOL under Fink]].
 +
|-
 +
! PyMOL
 +
| PyMOL now has a [[Set]] command for basic settings, and a [[Set_bond]] command for bond-only settings.
 +
|-
 +
! PyMOL
 +
| [[Space]]&mdash; new command to control PyMOL's usage of color spaces.
 +
|}
 +
|style="vertical-align: top; width: 40%"|
 +
{| class="jtable" style="float: right; width: 90%"
 +
|+ style="font-size: 1.4em; font-weight: bold; text-align:left; border-bottom: 2px solid #6678b1;" |Do you know this PyMOL command...
 +
|-
 +
|<div class="didyouknow" >
 +
<dpl>
 +
namespace=
 +
category=Commands
 +
includepage=*
 +
includemaxlength=300
 +
escapelinks=false
 +
resultsheader=__NOTOC__ __NOEDITSECTION__
 +
randomcount=1
 +
mode=userformat
 +
addpagecounter=true
 +
listseparators=,<h3>[[%PAGE%]]</h3>,,\n
 +
</dpl>
 +
</div>
 +
<div style="clear: both;"></div>
 +
|}
 +
|
 +
|style="vertical-align: top; width: 18%"|
 +
<dpl>
 +
imagecontainer=Covers
 +
randomcount=1
 +
escapelinks=false
 +
openreferences=true
 +
listseparators=[[,%PAGE%,|thumb|185px|A Random PyMOL-generated Cover. See [[Covers]].]],\n
 +
</dpl>
 +
|}

Revision as of 13:00, 17 November 2009

New

  • Due to wiki code (or my inability) I couldn't get images to float left/right in the table w/o it looking really ugly. So, if someone can get say the Colorama example to float right and look good, please do.
  • Let me know if you like the updates to the main page. I like it because it utilizes more of the screen real estate. Thus, no scrolling (for me). If you can clean it up, and make it prettier, feel free. Tree 17:08, 9 December 2007 (CST)
  • So, I found out, finally, why it's been hard to find things. Category pages aren't scanned for keywords for searching. So, we'll need to move our category pages' text to new pages and make the links. For example, searching for "mencoder" didn't work before today. Since I moved [[:Category:Software_Movies]] to Making_Movies we can now search for the keywords in that page.
  • Well, one idiot/spammer made it through the new system. If there's an influx of the idiots, we may go back to the old registration method, as that seemed pretty secure.
  • Feature Request: Support for 3D DLP and plasma HDTVs. These require a different stereo output format (checkerboard.) Feel free to contact me for details. --Martyholloway 17:46, 30 May 2008 (CDT)

Some Thoughts For Discussion

  • Folks, please check out the section MediaWiki Image Galleries for cleaning up the code for inserting more than one image. This fixes the problem of having to insert tons of blank lines to cleanly offset the following text. So, if you have some time, please head back to old pages and help clean this up.
  • We need to accurately document settings for PyMol. This would greatly improve the value of the site. We should also provide images and examples.
  • For people (like me) who don't know the first thing about Wiki's, more "newbies click here to learn" links would help ease the transition...


Where is the anti-spam mechanism/strategy?

Manual removing spam contents really sucks.


Edit by AdShea One good strategy is to search all namespaces for 'http' (without the quotes). This will show links containing that string, which should catch any spam links.

Needed Editing

Needed edits are the following:

  1. We need more thorough "See Also" sections on each page. Mesh shows what each page should look like. People need to be able to find their content easily.
    1. After some playing with this, I think we should create categories for each SET of settings. Like, "surface_settings" and then just put all the surface settings in there. Then, we can simply link out to this page and it'll change dynamically with the settings.
  2. We need to continue linking categories to their respective pages.
  3. More images should be uploaded for the settings changes so people can see what the settings do as well as read how to control them.

Searching

The default method for searching, eg hitting ENTER, should be the "Search" command not the "Go" command.

New Format

Code for the new page



Welcome to the PyMOL Wiki!
The community-run support site for the PyMOL molecular viewer.
Quick Links
Tutorials Table of Contents Commands
Script Library Plugins FAQ
Gallery | Covers PyMOL Cheat Sheet (PDF) GoogleSearch


News & Updates
Warren News about Warren DeLano's passing may be read on Warren's memorial page.
PyMOLWiki Reformatted Main Page.
PyMOLWiki New — Search the PyMOLWiki via GoogleSearch
PyMOL PyMOL is known to work under Mac OS X 10+ (Snow Leopard) using the new Fink and incentive builds. See Installing PyMOL under Fink.
PyMOL PyMOL now has a Set command for basic settings, and a Set_bond command for bond-only settings.
PyMOL Space— new command to control PyMOL's usage of color spaces.
Do you know this PyMOL command...

The DPL extension (version 2.3.0) produced a SQL statement which lead to a Database error.
The reason may be an internal error of DPL or an error which you made,
especially when using DPL options like titleregexp.
Query text is:
SELECT DISTINCT `pmw_page`.page_namespace AS page_namespace,`pmw_page`.page_title AS page_title,`pmw_page`.page_id AS page_id, `pmw_page`.page_title AS sortkey, `pmw_page`.page_counter AS page_counter FROM `pmw_page` INNER JOIN `pmw_categorylinks` AS cl0 ON `pmw_page`.page_id=cl0.cl_from AND (cl0.cl_to='Commands') WHERE 1=1 AND `pmw_page`.page_namespace IN (0) AND `pmw_page`.page_is_redirect=0 ORDER BY page_title ASC LIMIT 500 OFFSET 0

Error message is:
Unknown column 'pmw_page.page_counter' in 'field list' (localhost)


The DPL extension (version 2.3.0) produced a SQL statement which lead to a Database error.
The reason may be an internal error of DPL or an error which you made,
especially when using DPL options like titleregexp.
Query text is:
SELECT DISTINCT ic.il_to, ic.il_to AS sortkey FROM `pmw_imagelinks` AS ic WHERE 1=1 AND (ic.il_from=2199) ORDER BY pl_title ASC LIMIT 500 OFFSET 0

Error message is:
Unknown column 'pl_title' in 'order clause' (localhost)