diff options
author | pmichaud <pmichaud@524c5546-5005-0410-9a3e-e25e191bd360> | 2005-09-01 01:35:21 +0000 |
---|---|---|
committer | pmichaud <pmichaud@524c5546-5005-0410-9a3e-e25e191bd360> | 2005-09-01 01:35:21 +0000 |
commit | ef69f8c72bbe48b385b7092480a81f1e8ee6d06e (patch) | |
tree | c0a0756d7bcd7f150627e95c82084af1fa865a01 /wikilib.d/PmWiki.FAQ | |
parent | 7fc6d69e9bfb49e01ee99155250b66323c3ffaf8 (diff) | |
download | pmwiki.svn-ef69f8c72bbe48b385b7092480a81f1e8ee6d06e.tar.bz2 |
*** empty log message ***
git-svn-id: svn://pmwiki.org/trunk/pmwiki@792 524c5546-5005-0410-9a3e-e25e191bd360
Diffstat (limited to 'wikilib.d/PmWiki.FAQ')
-rw-r--r-- | wikilib.d/PmWiki.FAQ | 17 |
1 files changed, 8 insertions, 9 deletions
diff --git a/wikilib.d/PmWiki.FAQ b/wikilib.d/PmWiki.FAQ index 3dc3d3d7..2a530c03 100644 --- a/wikilib.d/PmWiki.FAQ +++ b/wikilib.d/PmWiki.FAQ @@ -1,11 +1,10 @@ -version=pmwiki-2.0.beta55 ordered=1 -newline=² -agent=Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.0) -author=Henning -host=199.41.197.19 +version=pmwiki-2.0.beta55 ordered=1 urlencoded=1 +agent=Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.7.10) Gecko/20050716 Firefox/1.0.6 +author=Pm +host=24.1.26.255 name=PmWiki.FAQ -rev=401 -targets=PmWiki.MailingLists,PmWiki.ErrorMessages,Site.EditForm,PmWiki.PmWiki,Cookbook.AuthUser,Cookbook.UserAuth,PmWiki.Troubleshooting,Site.Search,PmWiki.Security,PmWiki.AdvancedTables,PmWiki.SimpleTables,PmWiki.SimpleTables2,PmWiki.SpecialCharacters,PmWiki.LayoutBasics,PmWiki.Images,Site.EditQuickReference,PmWiki.PasswordsAdmin,PmWiki.WikiWord,PmWiki.WikiPage -text=(:title Frequently Asked Questions (FAQ):)²²This page tries to answer the more common questions you might want answered.²Many of the answers refer you to other pages for details.²²For frequently requested features, see the [[(PITS:)PITS]] pages.²²²>>faq<<²²Q: How do I get my question answered?²A: The quickest and best way is to join the pmwiki-users [[Mailing List(s)]] and post your question there. If it really is a frequently-asked question, it will eventually be added to this page.²²An alternative way is to leave your question on the [[(PmWiki:)Questions]] page.²²²Q: What does warning message or error message "xxxxx" mean?²A: Error/warning questions and answers are on the [[Error Messages]] page.²²²Q: How and why do I use the [[Site/EditForm]] feature?²A: This feature allows an admin to customize PmWiki's edit window. It is active by default in PmWiki version 2 beta 44 or later. Some [[Cookbook:Skins]] customize the $PageEditFmt variable which overrides the edit form, making it inoperative.²²²Q: How do I use passwd-formatted files (like .htpasswd) for authentication?²A: See [[Cookbook.AuthUser]] and [[Cookbook.UserAuth]]²²²Q: Where can I get help with PmWiki? (This is a pretty vague question!)²A: See this FAQ, [[Troubleshooting]], [[Error Messages]], or try a [[Site/Search]].²²²Q: I'm getting a lot of spam on my wiki site. How can I password protect the pages?²A: See [[PmWiki.Security]]²²²Q: How do I create nice tables similar to Product X? ²A: See [[Advanced Tables]]. Also check [[Simple Tables]] and [[Simple Tables2]]. ²²²Q: Why are '`RecentChanges', '`AllRecentChanges', '`RecentUploads', '`AllRecentUploads' editable?²A: You might want to edit these pages if a spammer creates a page with an unsavory name. To prevent others from editing these pages, insert the following lines into your ''local/config.php'' file. Editing then requires the admin password.²²[@²## Require admin password to edit RecentChanges (etc.) pages.²if ($action=='edit'² && preg_match('/\\.(All)?Recent(Changes|Uploads)$/',² $pagename)) { $DefaultPasswords['edit'] = '*'; }²@]²²²Q: How do I include special characters on my wiki pages?²A: Use character codes to insert special characters, such as Copyright (©) and Trademark (® or ™) symbols, that don't appear on your keyboard. See [[Special Characters]].²²²Q: Is it possible to move wiki.d to /tmp/persistent/wiki.d (a new sourceforge rule)?²A: Sourceforge suggest moving everything to /tmp/persistent/new-folder-of-your-choice and creating a soft link to the new folder on /tmp . It works. See [[Cookbook:SourceForgeServers]]²²²Q: How do I set one Header for all pages/groups?²A: Add the following to config.php² [=²$GroupHeaderFmt .= "Wikicode or text here";=]²²²Q: How do I insert RSS news feeds in PmWiki?²A: See [[Cookbook:RssFeedDisplay]].²²²Q: How do I change the Wiki's default name in the upper left corner of the Main Page.²A: Put the following config.php² [=²$WikiTitle = 'My Wiki Site';=]²²This appears in the sample-config.php file in the PmWiki distribution. Copy sample-config.php as "config.php" in your local/ directory and edit it.²²²Q: How do I customize the CSS styling of my PmWiki layout?[[#customcss]]²A: See [[LayoutBasics#modifyskin]] for how to modify the default PmWiki skin. See also [[Cookbook:Skins]], where you will find pre-made templates you can use to customize the appearance of your site. You can also create a file called local.css in the pub/css/ directory and add CSS selectors there (this file gets automatically loaded if it exists), or add them in your local ''local/config.php'' file by inserting something similar to:² [=²$HTMLStylesFmt[] = '² .foo { color:blue; }';=]²²²Q: How do I insert pictures on wiki pages?²A: See [[PmWiki/Images]].²²²Q: How do I link to an uploaded file from another group?²A: Use [@Attach:Groupname/filename.ext@]²²²Q: Is it possible to link an image on PmWiki without using a fully qualified URL?²A: Yes. The general format is [=Attach:GroupName/filename.ext=].²²²Q: How do I change the font or background color of the hints block on the Edit Page?²A: Add a CSS style to pub/css/local.css: [@.quickref {background:...; color:... }@]. The hints are provided by the [[Site.EditQuickReference]] page, which is in the PmWiki or Site wikigroup. Edit that page, and change the "bgcolor" or specify the font "color" to get the contrast you need.²²²Q: How do I make pmwiki.php the default page for a website? Should I rename pmwiki.php to index.php?²A: Renaming pmwiki.php is not recommended. Instead, create an ''index.php'' file that contains the single line:² [=²<?php include_once('pmwiki.php');=]²²You may also want to check [[Cookbook:CleanUrls]].²²²Q: When I upload a file, how do I make the link look like "file.doc" instead of "Attach:file.doc"?²A: Use parentheses, as in [@[[(Attach:)file.doc]]@]. You can make a configuration change that eliminates the [@Attach:@] -- see [[Cookbook:AttachLinks]].²²²Q: There seems to be a default password. What is it? [[#pwlocked]]²A: There isn't any valid password until you set one. See [[PasswordsAdmin]] for how to set an admin password.²²PmWiki comes "out of the box" with²$DefaultPasswords['admin'] set to '*'. This doesn't mean the password²is an asterisk, it means that default admin password has to be²something that encrypts to an asterisk. Since it's impossible for the²crypt() function to ever return a 1-character encrypted value, the admin²password is effectively locked until the admin sets one in config.php.²²²Q: How can I embed PmWiki pages inside a web page?²A: Source them through a PHP page, or place them in a frame.²²²Q: Why does pmwiki.org appear to have a directory structure rather than "?n=pagename" in [=URLs=]?²A: Pmwiki.org uses [[Cookbook:CleanUrls]].²²²Q: Can I remove items from the wikilib.d folder on my site?²A: Yes, the files in ''wikilib.d/'' can be safely removed. They'll reappear again when you upgrade, however. There's a permanent fix that can be done in a local configuration file (to be written soon in the cookbook). You may find it sufficient to leave the pages there and exclude wiki-related pages from searches.²²²Q: How do I exclude wiki-related pages from searches?²Try the following in your ''local/config.php file''. See also [[Cookbook:SearchPatterns]].²²[@²## Exclude Certain pages / groups from search results.²$SearchPatterns['default'][] = '!\\.(All)?Recent(Changes|Uploads)$!';²$SearchPatterns['default'][] = '!\\.Group(Print)?Header$!';²$SearchPatterns['default'][] = '!^Site\\.!';²$SearchPatterns['default'][] = '!^PmWiki\\.!';²@]²²²Q: How do I place a string of 10 tildes (~) onto a page?²A: To get [=~~=][=~~=][=~~=][=~~=][=~~=], use the following markup:² [=²[=~~=]=][=[=~~=]=][=[=~~=]=][=[=~~=]=][=[=~~=]=]²²²Q: How do I put a link that will open as a new window?²A: Use the [=%newwin%=] wikistyle, as in:²(:markup:) [=%newwin%http://www.example.com/=]²²²Q: How do I place a mailing address in a page?²A: Use the [@mailto:@] markup, as in²(:markup:) [=[[mailto:myaddress@example.com]]=]²or²(:markup:) [=[[mailto:myaddress@example.com | myaddress@example.com]]=]²²²Q: How do I make a WikiWord link to an external page instead of a WikiPage?²A: Use link markup. There are two formats:²(:markup:) [=[[http://www.example.com/ | WikiWord]]=]²or²(:markup:) [=[[WikiWord -> http://www.example.com/]]=] -time=1125319151 +rev=403 +targets=PmWiki.MailingLists,PmWiki.ErrorMessages,Site.EditForm,PmWiki.PmWiki,Cookbook.AuthUser,Cookbook.UserAuth,PmWiki.Troubleshooting,Site.Search,PmWiki.Security,PmWiki.SimpleTables,PmWiki.AdvancedTables,PmWiki.SpecialCharacters,PmWiki.Skins,PmWiki.Images,Site.EditQuickReference,PmWiki.PasswordsAdmin,PmWiki.WikiWord,PmWiki.WikiPage +text=(:title Frequently Asked Questions (FAQ):)%0a%0aThis page tries to answer the more common questions you might want answered.%0aMany of the answers refer you to other pages for details.%0a%0aFor frequently requested features, see the [[(PITS:)PITS]] pages.%0a%0a%0a>>faq%3c%3c%0a%0aQ: How do I get my question answered?%0aA: The quickest and best way is to join the pmwiki-users [[Mailing List(s)]] and post your question there. If it really is a frequently-asked question, it will eventually be added to this page.%0a%0aAn alternative way is to leave your question on the [[(PmWiki:)Questions]] page.%0a%0a%0aQ: What does warning message or error message "xxxxx" mean?%0aA: Error/warning questions and answers are on the [[Error Messages]] page.%0a%0a%0aQ: How and why do I use the [[Site/EditForm]] feature?%0aA: This feature allows an admin to customize PmWiki's edit window. It is active by default in PmWiki version 2 beta 44 or later. Some [[Cookbook:Skins]] customize the $PageEditFmt variable which overrides the edit form, making it inoperative.%0a%0a%0aQ: How do I use passwd-formatted files (like .htpasswd) for authentication?%0aA: See [[Cookbook.AuthUser]] and [[Cookbook.UserAuth]]%0a%0a%0aQ: Where can I get help with PmWiki? (This is a pretty vague question!)%0aA: See this FAQ, [[Troubleshooting]], [[Error Messages]], or try a [[Site/Search]].%0a%0a%0aQ: I'm getting a lot of spam on my wiki site. How can I password protect the pages?%0aA: See [[PmWiki.Security]]%0a%0a%0aQ: How do I create nice tables similar to Product X? %0aA: See [[simple tables]] and [[advanced tables]]. %0a%0a%0aQ: Why are '`RecentChanges', '`AllRecentChanges', '`RecentUploads', '`AllRecentUploads' editable?%0aA: You might want to edit these pages if a spammer creates a page with an unsavory name. To prevent others from editing these pages, insert the following lines into your ''local/config.php'' file. Editing then requires the admin password.%0a%0a[@%0a## Require admin password to edit RecentChanges (etc.) pages.%0aif ($action=='edit'%0a && preg_match('/\\.(All)?Recent(Changes|Uploads)$/',%0a $pagename)) { $DefaultPasswords['edit'] = '*'; }%0a@]%0a%0a%0aQ: How do I include special characters on my wiki pages?%0aA: Use character codes to insert special characters, such as Copyright (©) and Trademark (® or ™) symbols, that don't appear on your keyboard. See [[Special Characters]].%0a%0a%0aQ: Is it possible to move wiki.d to /tmp/persistent/wiki.d (a new sourceforge rule)?%0aA: Sourceforge suggest moving everything to /tmp/persistent/new-folder-of-your-choice and creating a soft link to the new folder on /tmp . It works. See [[Cookbook:SourceForgeServers]]%0a%0a%0aQ: How do I set one Header for all pages/groups?%0aA: Add the following to config.php%0a [=%0a$GroupHeaderFmt .= "Wikicode or text here";=]%0a%0a%0aQ: How do I insert RSS news feeds in PmWiki?%0aA: See [[Cookbook:RssFeedDisplay]].%0a%0a%0aQ: How do I change the Wiki's default name in the upper left corner of the Main Page.%0aA: Put the following config.php%0a%0a [@$WikiTitle = 'My Wiki Site';@]%0a%0aThis appears in the sample-config.php file in the PmWiki distribution. Copy sample-config.php as "config.php" in your local/ directory and edit it.%0a%0a%0aQ: How do I customize the CSS styling of my PmWiki layout?[[#customcss]]%0aA: See [[Skins]] for how to change the default PmWiki skin. See also [[Cookbook:Skins]], where you will find pre-made templates you can use to customize the appearance of your site. You can also create a file called local.css in the pub/css/ directory and add CSS selectors there (this file gets automatically loaded if it exists), or add them in your local ''local/config.php'' file by inserting something similar to:%0a%0a [@$HTMLStylesFmt[] = '%0a .foo { color:blue; }';@]%0a%0aQ: How do I insert pictures on wiki pages?%0aA: See [[PmWiki/Images]].%0a%0aQ: How do I link to an uploaded file from another group?%0aA: Use [@Attach:Groupname/filename.ext@]%0a%0aQ: Is it possible to link an image on PmWiki without using a fully qualified URL?%0aA: Yes. The general format is [@Attach:Group.PageName/filename.ext@].%0a%0a%0aQ: How do I change the font or background color of the hints block on the Edit Page?%0aA: Add a CSS style to pub/css/local.css: [@.quickref {background:...; color:... }@]. The hints are provided by the [[Site.EditQuickReference]] page, which is in the PmWiki or Site wikigroup. Edit that page, and change the "bgcolor" or specify the font "color" to get the contrast you need.%0a%0a%0aQ: How do I make pmwiki.php the default page for a website? Should I rename pmwiki.php to index.php?%0aA: Renaming pmwiki.php is not recommended. Instead, create an ''index.php'' file that contains the single line:%0a [=%0a%3c?php include_once('pmwiki.php');=]%0a%0aYou may also want to check [[Cookbook:CleanUrls]].%0a%0a%0aQ: When I upload a file, how do I make the link look like "file.doc" instead of "Attach:file.doc"?%0aA: Use parentheses, as in [@[[(Attach:)file.doc]]@]. You can make a configuration change that eliminates the [@Attach:@] -- see [[Cookbook:AttachLinks]].%0a%0a%0aQ: There seems to be a default password. What is it? [[#pwlocked]]%0aA: There isn't any valid password until you set one. See [[PasswordsAdmin]] for how to set an admin password.%0a%0aPmWiki comes "out of the box" with%0a$DefaultPasswords['admin'] set to '*'. This doesn't mean the password%0ais an asterisk, it means that default admin password has to be%0asomething that encrypts to an asterisk. Since it's impossible for the%0acrypt() function to ever return a 1-character encrypted value, the admin%0apassword is effectively locked until the admin sets one in config.php.%0a%0a%0aQ: How can I embed PmWiki pages inside a web page?%0aA: Source them through a PHP page, or place them in a frame.%0a%0a%0aQ: Why does pmwiki.org appear to have a directory structure rather than "?n=pagename" in [=URLs=]?%0aA: Pmwiki.org uses [[Cookbook:CleanUrls]].%0a%0a%0aQ: Can I remove items from the wikilib.d folder on my site?%0aA: Yes, the files in ''wikilib.d/'' can be safely removed. They'll reappear again when you upgrade, however. There's a permanent fix that can be done in a local configuration file (to be written soon in the cookbook). You may find it sufficient to leave the pages there and exclude wiki-related pages from searches.%0a%0a%0aQ: How do I exclude wiki-related pages from searches?%0aTry the following in your ''local/config.php file''. See also [[Cookbook:SearchPatterns]].%0a%0a[@%0a## Exclude Certain pages / groups from search results.%0a$SearchPatterns['default'][] = '!\\.(All)?Recent(Changes|Uploads)$!';%0a$SearchPatterns['default'][] = '!\\.Group(Print)?Header$!';%0a$SearchPatterns['default'][] = '!^Site\\.!';%0a$SearchPatterns['default'][] = '!^PmWiki\\.!';%0a@]%0a%0a%0aQ: How do I place a string of 10 tildes (~) onto a page?%0aA: To get [=~~=][=~~=][=~~=][=~~=][=~~=], use the following markup:%0a [=%0a[=~~=]=][=[=~~=]=][=[=~~=]=][=[=~~=]=][=[=~~=]=]%0a%0a%0aQ: How do I put a link that will open as a new window?%0aA: Use the [=%25newwin%25=] wikistyle, as in:%0a(:markup:) [=%25newwin%25http://www.example.com/=]%0a%0a%0aQ: How do I place a mailing address in a page?%0aA: Use the [@mailto:@] markup, as in%0a(:markup:) [=[[mailto:myaddress@example.com]]=]%0aor%0a(:markup:) [=[[mailto:myaddress@example.com | myaddress@example.com]]=]%0a%0a%0aQ: How do I make a WikiWord link to an external page instead of a WikiPage?%0aA: Use link markup. There are two formats:%0a(:markup:) [=[[http://www.example.com/ | WikiWord]]=]%0aor%0a(:markup:) [=[[WikiWord -> http://www.example.com/]]=] +time=1125531791 title=Frequently Asked Questions (FAQ) |