PmWiki /
FAQThis page will attempt to summarize some of the more commonly asked questions. The answers are on the corresponding pages (see link). If you have a question which isn't answered here, you can leave your question on the Questions page or search for documentation using the search facility. More documentation can be found on the documentation index page. ImagesWhy are some external images correctly embedded, and others aren't? If the current page is on a secure URL with the "https://" protocol, some browsers will refuse to load pictures from insecure URLs (the other way around is allowed). Also, some webmasters configure their servers to disallow hotlinking Is it possible to link an image on PmWiki without using a fully qualified URL? Yes. For images that are attachments, the general format is Can I attach a client image file on PmWiki? Yes, see Uploads . How can I include a page from another group that contains an attached image? Include the page in the normal way, ie Why, if I put an image with rframe or rfloat and immediatly after that I open a new page section with ! the section title row is below the image instead of on the left side? Because the CSS for headings such as ! contains an element clear:both which forces this behaviour. Redefine the CSS locally if you want to stop this happening, but I think the bottom border (that underlines the heading) would need further re-definition. I just use bolding for the title, and 4 dashes below ---- to separate a new section, and it saves the effort of fiddling with the core definitions. Unlike the lframe and rframe directives, cframe does not fully honour the width setting. While the frame itself resizes to match the request, the enclosed image does not, and retains its original width. Effect is the same in IE and Fx. I've added an example beneath the standard example above. Is it possible to disallow all images? I already disabled uploads but I also want to disallow external images from being shown on my wiki pages. Yes, add to config.php: DisableMarkup('img'); $ImgExtPattern = "$^"; How can I make it so that when I place an image in a page, the block of text it is in is a <p> (paragraph) rather than a <div> (division)? If you just want it to happen for a single image (instead of all), then
try putting [==] https://www.pmwiki.org/pub/pmwiki/pmwiki-32.gif
Having Is there any way to use relative paths for images? See Cookbook:RelativeLinks and Is there a way to attach a BMP and have it display rather than link? Add to config.php the following line: How do I add an image type to You can append the extensions to the Is there a way to have a table to the left or right of an image? Yes, see TableAndImage. TablesHow do I create a basic table? Tables are created via use of the double pipe character:
How do I create cell headers? Header cells can be created by placing ! as the first character of a cell. Note that these are table headers, not headings, so it doesn't extend to !!, !!!, etc.
How do I obtain a table with thin lines and more distance to the content? "Thin lines" is tricky and browser dependent, but the following works for Firefox and IE (Nov. 2009):
How do I create an advanced table? See table directives My tables are by default centered. When I try to use '||align=left' they don't align left as expected. Use ||style="margin-left:0px;" instead. How can I specify the width of columns? You can define the widths via custom styles, see Cookbook:FormattingTables and And add in pub/css/local.css :
table.column td.col1 { width: 120px; } table.column td.col3 { width: 40px; } How can I display a double pipe "||" in cell text using basic table markup? Escape it with How do I apply styles to the elements of the table, like an ID to the table row, or a class/style to the TD? See $WikiStyleApply. Alternately, use table directives, which allow specifying styling either directly (style="...") or by a class="..." attribute for CSS. PageDirectives Can I get Use Is there any way to prevent the "redirected from" message from showing at the top of the target page when I use From version 2.2.1 on, set in config.php Is there any method for redirecting to the equivalent page in a different group, i.e. from BadGroup/thispage => GoodGroup/thispage using similar markup to (:redirect Goodgroup.{Name}:)?
(:redirect Goodgroup.{$Name}:) works if you want to put it in one page.
If you want it to work for the entire group, put (:redirect Goodgroup.{*$Name}:) into Badgroup.GroupHeader - however, that only works with pages that really exist in Goodgroup; if you visit a page in Badgroup without a corresponding page of the same name in Goodgroup, instead of being redirected to a nonexistant page, you get the redirect Directive at the top of the page.
With (:if exists Goodgroup.{*$Name}:)(:redirect Goodgroup.{*$Name}:)(:ifend:) in Badgroup.GroupHeader you get redirected to Goodgroup.Name if it exists, otherwise you get Badgroup.Name without the bit of code displayed.
How can a wiki enable linebreaks by default, i.e. without having the directive Add to config.php such a line: WikiTrails
What's the difference between a PageList and a WikiTrail? The pagelist directive dynamically generates a list of pages. There are many ways to generate the list, including using a WikiTrail as the source. The pagelist directive then displays the pages that match the criteria using an optional template - for example displaying each page name on a separate line as a link or including the entire content. The pagelist directive currently does not have built-in navigation markup that you can put on the pages in the list. By contrast, WikiTrails are simply specified via links on an "index" page and you can put previous-next navigation markup on each page. The two serve very different purposes. WikiTrails are useful for specifying the pages in web feeds, for creating a "tour" through a predefined set of pages, and many other things. CustomMarkupHow can I embed JavaScript into a page's output? There are several ways to do this. The Cookbook:JavaScript recipe describes a simple means for embedding static JavaScript into web pages using custom markup. For editing JavaScript directly in wiki pages (which can pose various security risks), see the JavaScript-Editable recipe. For JavaScript that is to appear in headers or footers of pages, the skin template can be modified directly, or <script> statements can be inserted using the How would I create a markup ((:nodiscussion:)) that will set a page variable ({$HideDiscussion}) which can be used by (:if enabled HideDiscussion:) in .PageActions? Add the following section of code to your config.php SDV($HideDiscussion, 0); #define var name Markup('hideDiscussion', '<{$var}', '/\\(:nodiscussion:\\)/', 'setHideDiscussion'); function setHideDiscussion() { global $HideDiscussion; $HideDiscussion = true; } This will enable the It appears that (.*?) does not match newlines in these functions, making the above example inoperable if the text to be wrappen in <em> contains new lines. If you include the "s" modifier on the regular expression then the dot (.) will match newlines. Thus your regular expression will be "/STUFF(.*?)/s". That s at the very end is what you are looking for. If you start getting into multi-line regexes you may be forced to look at the m option as well - let's anchors (^ and $) match not begin/end of strings but also begin/end of lines (i.e., right before/after a newline). Also make sure your markup is executed during the fulltext phase. How can the text returned by my markup function be re-processed by the markup engine? If the result of your markup contains more markup that should be processed, you have two options. First is to select a "when" argument that is processed earlier than the markup in your result. For example, if your markup may return [[links]], your "when" argument could be How do I get started writing recipes and creating my own custom markup? (alternate) Introduction to custom markup for Beginners How do I make a rule that runs once at the end of all other rule processing? Use this statement instead of the usual
DesignNotesWhy doesn't PmWiki use hierarchical / nested groups? It essentially comes down to figuring out how to handle page links between nested groups; if someone can figure out an obvious, intuitive way for authors to do that, then nested groups become plausible. See Design Notes and PmWiki:Hierarchical Groups. Why don't PmWiki's scripts have a closing ?> tag? All of PmWiki's scripts now omit the closing ?> tag. The tag is not required, and it avoids problems with unnoticed spaces or blank lines at the end of the file. Also, some file transfer protocols may change the newline character(s) in the file, which can also cause problems. See also the Instruction separation page in the PHP manual. Does PmWiki support WYSIWYG editing (or something like the FCKEditor)? Short answer: PmWiki provides GUI buttons in a toolbar for common markups, but otherwise does not have WYSIWYG editing. For the reasons why, see PmWiki:WYSIWYG. Categories: PmWiki Developer
This page may have a more recent version on pmwiki.org: PmWiki:FAQ, and a talk page: PmWiki:FAQ-Talk. |