+{maketoc} |
One or more images can be inserted into any wiki page, blog entry, and news article in bitweaver.
|
|
-__Filetypes:__ Bitweaver supports jpeg, gif and png.
|
+__Filetypes:__ Bitweaver supports most image file types thanks to it's use of either ((GD libraries)), the ((imagemagick)) or the ((magickwand)) estensions. |
|
-When creating a news article you are promted to upload and resize an image. For blog posts and wiki pages, the process is slightly more complicated - you need to upload a picture to the image galleries first and then link to it on the page using the wiki syntax (image tag).
|
+__Images in news articles. __When creating or editing a news article users can upload and resize an image which is displayed in the upper left corner of the article. No plugin is required for this use. |
|
-!!To upload images:
|
-Bitweaver uses the ((fisheye)) package to store and view image files. By default, each user has an image folder created for them, and a fixed amount of storage space.
|
+__Images in blog posts and wiki pages__ In order to place images in wiki pages or blogs, __you need to upload a picture first__ (via the images galleries) and then use the path to approriate gallery as the "src" (source) parameter plugin. |
|
-__URL:__ http://yoursite.com/fisheye/upload.php
|
+^__The image tag:__ |
+syntax: ~np~ {img src= width= height= align= desc= link= } ~/np~^ |
|
-The fisheye upload screen, it is easy to upload multiple images (one after the other), and store them in a file gallery for later use.
|
+To put an image into a page, you need to know its directory path. Once you are viewing (in the fisheye gallery) the image you want to place on a page, then right-click ''copy image location'' to copy the path. Then return to the page you would like to include the image into and use the image tag. |
|
-!!Image Galleries
|
+!!Image Plugin Parameters |
+__using HTML__ The ((parameter))s used in the ~np~{ img }~/np~ plugin are the same as the parameters in the HTML "img" tag. Since the plugin syntax is the same as the html syntax, you may use the ~np~ { and < ~/np~brackets interchangably (if html is allowed). |
|
-In Bitweaver all content is assigned a number as well as a name, and image gallaries are no exception.
|
+|| __::Parameter::__ | __::Values allowed::__ | __::Description::__ | __::Example::__ |
+src |URL |The URL of the image to display |
+desc |"text" |Defines a short description of the image |
+align |center, left, right |Specifies how to align the image according to surrounding text. |
+height |pixels or % |Sets the height of the image |400 |
+width |pixels or % |Sets the width of the image |600 |
+link |URL |If you insert a link, clicking the image will take you to that location|| |
|
-A list of all galleries is available at:
|
-http://highproductivity.ca/fisheye/index.php
|
|
-You can view any gallery directly by knowing the gallery ID number.
|
-http://yoursite.com/fisheye/view.php?gallery_id=1
|
+__using CSS__ if the img (html tag?) and the description are enclosed within ~np~ <div> ~/np~ tags you can use various css parameters: |
+The following parameters take CSS style parameters |
|
-You can also link directly to an image (displayed by itself)
|
-http://yoursite.com/fisheye/view_image.php?image_id=6&gallery_path=/1
|
+|| __::Parameter::__ | __::Values allowed::__ | __::Description::__ | __::Example::__ |
+float | |If you want to float the image. |right |
+padding | |Padding around the image. |5px |
+margin | |Margin around the image. |5px |
+background | |Background colour around the image. |#ff6600 |
+border | |Defines a border around an image. |3px solid pink |
+text-align | |Will help you align the description with the image |center |
+color | |Colour of the description that goes with the image |#990000 |
+font | |Font settings for the description | |
+font-size | |Font size of the description |10px |
+font-weight | |Font weight of the description |bold |
+font-family | |Font family for the description text |Verdana, sans-serif|| |
|
-!!Inserting an image in a page.
|
+!! Uploading images to an image gallery. |
+Bitweaver uses the ((FisheyePackage|fisheye)) package to store and view image files. By default, each user has an image folder created for them, and a fixed amount of storage space. In Bitweaver all content is assigned a number as well as a name, and image galleries are no exception. |
|
-To put an image into a page, you need to know its directory path. Once you are viewing (in the fisheye gallery) the image you want to place on a page, then right-click ''copy image location'' to copy the path. Then return to the page you would like to include the image into and use the image tag.
|
+__URL:__ http://yoursite.com/fisheye/upload.php |
|
-__The image tag:__
|
-syntax: ~np~ {img src= width= height= align= desc= link= } ~/np~
|
+The fisheye upload screen, it is easy to upload multiple images, and store them in a file gallery for later use. |
|
-__Note:__ The ((parameter))s used in this tag are the same as the parameters in the HTML "img" tag. You can pretty much swap the ~np~ { and < ~/np~brackets interchangably, if you are allowing bitweaver to parse html.
|
+A list of all galleries is available at: |
+http://yoursite.com/fisheye/index.php |
|
-When using ~np~{ img}~/np~ the image and the description are enclosed with a "div" tag, that you can style with various css parameters:
|
+You can view any gallery directly by knowing the gallery ID number. |
+http://yoursite.com/fisheye/view.php?gallery_id=1 |
+ |
+You can also link directly to an image (displayed by itself) |
+http://yoursite.com/fisheye/view_image.php?image_id=6&gallery_path=/1 |
|
- * border
|
- * padding
|
- * width
|
- * float
|
- * color
|
- * background
|
- * border
|
- * text-align
|
+!!Uploading images as attachment |
+As an alternate method, you can directly upload images to the server as wiki page attachments. Once it is attached, you can then use either the img plugin or the ((DataPluginAttachment|Attach)) plugin to display it. This will not place the image in a gallery and the image can only be viewed when included in a wiki page or article. Since the method requires the same amount of steps it is not a short cut. |
|
-!!!Inserting an image as an attachment.
|
+__Inserting an image as an attachment__ |
An image file (or any other kind of file) and be attached to the page using the attachments tab in the edit screen. This can be used to upload a file instead of going to the fisheye/upload page, with an identical result.
|
1. Opening the attachments tab, upload the image as an attachment.
|
2. Save. The image will appear thumbnailed and right aligned on the page.
|