Notes on Using the Forum

{| cellspacing="0" cellpadding="8" border="0" style="text-align: center; width: 100%; background-color: #ecffec;"
|-
| style="color: green; font-weight: bold; font-style: italic; font-size: 11px;" | '''PLEASE NOTE:''' If you have a question about SMath Studio that isn't answered in this wiki, posting your question on the [http://smath.info/forum/|SMath forum] might help you find the answer
|}

((('''Index'''
* [#Bug_Reports_and_Feature_Requests|Bug Reports and Feature Request]
* [#Preview_before_Posting|Please Use the Forum's "Preview" Button before Posting]
* [#How_to_Include_Pictures_Attachments_Expressions_in_Forum_Postings|How to Include Pictures, Attachments, and SMath Studio Expressions in Forum Postings]
* [#Files_Attachments_Forum|Direct Files and Pictures attachments on the forum]
* [#Files_Attachments_Wiki_1_Storing|Files and Pictures attachments on the forum with wiki - PART 1: Storing the file in the wiki]
* [#Files_Attachments_Wiki_2_Including|Files and Pictures attachments on the forum with wiki - PART 2: Including Them in Your Forum Posting]
* [#Copying-and-pasting_an_Expression|Copying-and-pasting an Expression from SMath Studio to the Forum])))


{BR}Here there are some tips for using the forum:	

{BR}	
==[anchor|#Bug_Reports_and_Feature_Requests]Bug Reports and Feature Requests==	
	
If you want to post a bug report or a feature request:
		

# '''First browse the forum some''', in case the item has already been brought up. <esc>&nbsp;</esc>If the item ''has'' been mentioned, then you can just reply with something like, "This bug affects me too" or "This feature would help me too."{BR}{BR}
# '''Please mention what version of SMath Studio you are using'''. This will prevent confusion in the following scenario:{BR}{BR}a. A bug is reported or a feature is requested.{BR}{BR}b. The program is updated accordingly.{BR}{BR}c. Someone adds a reply to the forum topic, causing the topic to go to the top of the list (because topics are sorted by most recent reply date).{BR}{BR}d. People assume the topic applies to the current program version, because they don't notice the date the topic was started; again, this problem scenario can be avoided by listing the SMath Studio application version in your posting.

{BR}	
==[anchor|#Preview_before_Posting]Please Use the Forum's "Preview" Button before Posting==

[image||{UP}using_the_forum/forum_Preview_button.png]

This will help you to catch mistakes, or clarify unclear statements you make, before other people see them.

{BR}
==[anchor|#How_to_Include_Pictures_Attachments_Expressions_in_Forum_Postings]How to Include Pictures, Attachments, and SMath Studio Expressions in Forum Postings==

===[anchor|#Including_Pictures_Attachments_Expressions_Overview]Overview===

Three kinds of non-text material can be included in your forum postings:


# '''Pictures''' (usually screen captures){BR}
# '''Attachments''' (usually *.sm, *.smz or *.xmcd files){BR}
# SMath Studio '''expressions'''{BR}

There are two reccomended ways to attach files and images to the forum.

* Directly with forum "post attachments" option (see [#Files_Attachments_Forum|direct attachments])

* Indirectly, storing the file in the wiki (see part 1:[#Files_Attachments_Wiki_1_Storing|Storing on wiki] and part 2:[#Files_Attachments_Wiki_2_Including|Including in the forum])

{{{{'''PLEASE NOTE:'''

Some people have considered using 3rd-party free file-hosting services for storing forum attachments.

These services usually delete the files automatically after some time, however.

Instead, attachments to forum postings should not expire until the author of the posting deletes them and deletes any links to them.

So the Wiki is preferable for storing forum files.}}}}

SMath Studio expressions are shown directly in the posting, but are stored only in the text of your posting itself, by means of forum markup code (see [#Copying-and-pasting_an_Expression|Copying-and-pasting an Expression from SMath Studio to the Forum]).

The following sections explain how to include these 3 kinds of non-text material in a forum posting.  

{BR}
===[anchor|#Files_Attachments_Forum]Direct Files and Pictures attachments on the forum===

Follow these steps:

1. write your post

2. pick the "'''Attach files to this post?'''" option on the bottom-left corner

3. click on the "'''POST'''" button

{{{{[image||{UP}forum_attach/attachment_wiki_001.png]}}}}

Now you are redirect in the "'''Attachments'''" page

4. click on "'''Browse...'''" and search the file/image you want to attach (be careful because max size is ''3906 kb''; if the file it's too big zip it)

5. click on the "'''Upload'''" button to upload the single file in the forum

''repeat these two steps for each file you want to attach''

{{{{[image||{UP}forum_attach/attachment_wiki_002.png]}}}}

6. finally click on the "'''Back'''" button to post message and attachments

{{{{[image||{UP}forum_attach/attachment_wiki_003.png]}}}}

All files are added inside a box in the bottom side of your post

{{{{[image||{UP}forum_attach/attachment_wiki_004.png]}}}}

After posting, you can add new attachments or delete old by clicking on the "'''ATTACH'''" button on the top-left corner of your post

{{{{[image||{UP}forum_attach/attachment_wiki_005.png]}}}}

{BR}
===[anchor|#Files_Attachments_Wiki_1_Storing] Files and Pictures attachments on the forum with wiki - PART 1: Storing the file in the wiki===

The difference with previous method is in how the file is included in your forum posting, not in a separate window on the bottom of the post (with dedicated downloads and views counter) but inside the message body; furthermore:

* pictures are shown directly in the posting

* attachments are shown as a link that a reader can click on to download them. 

First, from any page of the Wiki, select the Navigation menu's File Management option, shown in this picture:  

[image||{UP}using_the_forum/storing_files_on_the_Wiki/1_Wiki_navigation_menu_File_Management_option.png]

Once you select that option, you will be presented with a Wiki login page if you aren't already logged in. <esc>&nbsp;</esc>Logging in requires an account on the Wiki. <esc>&nbsp;</esc>On the login page, you will be given the option to start an account if you don't have such an account yet.  

Once you are logged into the Wiki to upload a file, please first navigate to the 'forum_attach' folder, as shown:  

[image||{UP}using_the_forum/storing_files_on_the_Wiki/2_Wiki_forum_attach_folder.png]

Then, preferably, make a subfolder for your files, so that at any time later on, you can quickly tell which files are yours. 

{BR}
====[anchor|#Please_Note]Note:====

* Please be considerate of others who store files on the Wiki.

* Please consider to use '''forum_attach/{USERNAME}''' as your folder for forum attachments and leave other folders for WIKI purposes.

* '''Please delete your files from the Wiki once they are no longer needed on the forum.''' <esc>&nbsp;</esc>Also delete the links to these files from your forum posting, if the posting has not already been automatically 'pruned.'.

* *.sm files cannot be uploaded to the Wiki directly - therefore please archive *.sm files into *.zip format instead.

* Files should not have apostrophes (') in their names. <esc>&nbsp;</esc>If they do, then if you want to rename them, you won't be able to do so using the Wiki's File Management screens; to rename the files, you will have to delete them and re-upload them with the new names.  

{BR}
===[anchor|#Files_Attachments_Wiki_2_Including] Files and Pictures attachments on the forum with wiki - PART 2: Including Them in Your Forum Posting===

The File Management pages of the Wiki show you the ending part of the URL you will need in order to include your file in your forum posting. <esc>&nbsp;</esc>For example, if you store a file called "some_file.zip" in a Wiki subfolder called "some_username" under the "forum_attach" folder, the Wiki will show you that ''<nowiki>{UP}forum_attach%2fsome_username%2fsome_file.zip</nowiki>'' is the location of the file, as follows:  

[image||{UP}using_the_forum%2fincluding_files_in_forum_posting%2fWiki_file_location_example.png]

(The %2f is HTML code which the Wiki uses to represent the / character.)  

To convert this ending part to the full URL, change

{{{{<nowiki>{UP}</nowiki>}}}}

to

{{{{http://smath.info/wiki/GetFile.aspx?File=}}}}  

The full URL is used with forum code to include the picture or attachment in your posting. <esc>&nbsp;</esc>Options for doing this are described next.  

* You can use the toolbar buttons, just above the forum text-entry box, to insert forum code for you. <esc>&nbsp;</esc>Or you can type the code by hand if you insist. <esc>&nbsp;</esc>The following code examples are given to help you understand how the forum code works, in case some code that you insert via the toolbar doesn't produce the result you expect. 

* The forum code for a hyperlink called __example__ to make the hypothetical "some_file.zip" into an attachment would be:  

{{{{<nowiki>[url=http://smath.info/wiki/GetFile.aspx?File=forum_attach%2fsome_username%2fsome_file.zip]example[/url]</nowiki>}}}}

* You can change the %2f (or other similar codes you may see) to their normal representation if you want ('/' in this case - without the ' ' tick marks, of course). <esc>&nbsp;</esc>People's web browsers will access the file either way.  

* If you don't want to bother with giving your link a name, '''you can put just the URL in your forum posting.''' <esc>&nbsp;</esc>This will cause the forum to show the beginning and ending parts of the URL as the hyperlink text. <esc>&nbsp;</esc>The following entered into your forum posting:  

{{{{<nowiki>http://smath.info/wiki/GetFile.aspx?File=forum_attach%2fsome_username%2fsome_file.zip</nowiki>}}}}

... will be posted as:  

(((__'''http://smath.info/wiki/G...sername%2fsome_file.zip'''__)))

* To show a picture, just put {{<nowiki>[img]</nowiki>}} and {{<nowiki>[/img]</nowiki>}} around the URL:  

{{{{<nowiki>[img]http://smath.info/wiki/GetFile.aspx?File=forum_attach%2fsome_username%2fsome_picture.jpg[/img]</nowiki>}}}}

{BR}
===[anchor|#Copying-and-pasting_an_Expression]Copying-and-pasting an Expression from SMath Studio to the Forum===

Through the clipboard you can share any individual math expression from the SMath Studio application by using the MATH forum tag. <esc>&nbsp;</esc>(You cannot copy multiple expressions at one time, but you can include multiple expressions in your forum posting by copying them one at a time and using a separate MATH tag for each.) <esc>&nbsp;</esc>Please take a look at the screenshots below.  

First, here's how you select the MATH tag in the forum's postings editor:  

[imageauto|Figure 1: <esc>&nbsp;</esc>Using MATH tag of the SMath Studio forum.|http://smath.info/?file=738772&type=image]

Now let's discuss copying the expression itself from SMath Studio.  

To select the expression in SMath Studio for copying, you canNOT just drag a selection rectangle over the expression as though you were going to move the expression on the page:  

[imageauto|Figure 2: <esc>&nbsp;</esc>Wrong selection method for pasting an expression into forum.|{UP}using_the_forum/pasting_an_expression_into_forum/02_wrong_selection_method.png]

Instead, first click anywhere in the expression, to open the expression for editing: 

[imageauto|Figure 3: <esc>&nbsp;</esc>The first step in selecting an expression for copy-and-paste.|{UP}using_the_forum/pasting_an_expression_into_forum/03_step_1_in_selecting.png]

Then, within the selection rectangle that appeared around the expression, drag the mouse pointer over the expression so that the part you want is highlighted:  

[imageauto|Figure 4: <esc>&nbsp;</esc>The second step in selecting an expression for copy-and-paste.|{UP}using_the_forum/pasting_an_expression_into_forum/04_step_2_in_selecting.png]

Next, copy-and-paste into the forum's text-entry box, as shown:  

[imageauto|Figure 5: <esc>&nbsp;</esc>Copying an expression to the forum via standard system clipboard.|http://smath.info/?file=738773&type=image]

'''Note:''' <esc>&nbsp;</esc>Each time someone views your forum posting, the expression is converted from text format to picture format by a Web service that's hosted on the smath.info website. <esc>&nbsp;</esc>This Web service interprets the character ';' as a function arguments delimiter and ',' as a decimal symbol. <esc>&nbsp;</esc>If your locale settings are different than these, then the text formatting that is produced when you copy the expression from your SMath Studio will be incompatible with the mentioned Web service. <esc>&nbsp;</esc>You can easily avoid this problem, as described next.  

For example, if your locale settings use the ',' character for function arguments and '.' as the decimal symbol, you might have something like the following in an SMath Studio worksheet:  

[imageauto|Figure 6: <esc>&nbsp;</esc>Expressions as-localized in SMath Studio.|{UP}using_the_forum/pasting_an_expression_into_forum/06_expressions_as-localized_in_SMath_Studio.png]

Pasting the "if" into the forum produces the following: 

[imageauto|Figure 7: <esc>&nbsp;</esc>Expression pasted into forum per locale of author of posting.|{UP}using_the_forum/pasting_an_expression_into_forum/07_expression_pasted_into_forum_per_locale_of_author_of_posting.png]

... which then appears on the forum as follows:  

[imageauto|Figure 8: <esc>&nbsp;</esc>Expression rendered per locale of smath.info.|{UP}using_the_forum/pasting_an_expression_into_forum/08_expression_rendered_per_locale_of_SMath.info.png]

To avoid this, once the text is pasted into the forum, manually change the function arguments delimiters to ';' and the decimal symbols to ',':  

[imageauto|Figure 9: <esc>&nbsp;</esc>Expression edited for locale.|{UP}using_the_forum/pasting_an_expression_into_forum/09_expression_edited_for_locale.png]

This produces:  

[imageauto|Figure 10: <esc>&nbsp;</esc>Expression successfully shown in forum.|{UP}using_the_forum/pasting_an_expression_into_forum/10_example_result.png]

Much better!

Forum has been improved in this way, regarding copy/paste from SMath into the math tag. There are math tags '''lang=eng''' and '''lang=rus''' now and expression pasted with locale settings using the ',' character for function arguments and '.' as the decimal symbol just need lang=eng. For example:

[imageauto|Figure 11: <esc>&nbsp;</esc>Expression pasted into forum per locale of author of posting.|{UP}using_the_forum/pasting_an_expression_into_forum/langeng1.png]

will be presented as expected.

[imageauto|Figure 12: <esc>&nbsp;</esc>Expression successfully shown in forum.|{UP}using_the_forum/pasting_an_expression_into_forum/langeng2.png]

Without lang=* then lang=rus is considered and ';' and ',' are used as argument separator and decimal symbol respectively.