Publisher User's Guide

Publisher is a Whian.net stand-alone application for Mac OS X and Windows operating systems. It's used for creating and managing article (website) content of the websites based on Whian.net content management system (CMS).
It is also possible to download this User guide for Publisher.


  1. Doubleclick Publisher to Start it
    Whian.net Publisher Icon

  2. Settings window will open, if not all settings are set or Publisher cannot connect.

    If you are our customer, you get your copy of Publisher with all data you need and settings window will not show on startup.

    Settings window - connect dataThis part of settings window will show only, if you need to download data for his server. If our customer decided to publish these information, you can write the address, click "Continue" and information will download.

    This feature is useful if you want to use your website as portal and allow users to register.


    Settings window - user settingsThis part of settings window will show, if your user settings are missing.

    First, you can change the default location, where downloaded articles (webpages) will be saved and read from.

    Next, you can set your account information. Make sure all information are set correctly - fullname, login, password - otherwise, you will not be able to connect to your account, send and download your articles (webpages).


    Settings window - more settingsClick button for "More settings" to choose, if you want to display the Styled or HTML code view by default.


    back to top
  3. List of articles is crossroad of Publisher and will be opened on start. If your account information are correct, it will start to load information about online articles (webpages) that belong to your account. You can see progress in the status under toolbar.

    List of articlesFrom this window, you can create new or change your existing articles (webpages), refresh their list, or change settings - using the toolbar icons.

    Using buttons on the bottom of the window, you can send your articles (webpages) online, download, pair or even delete them.

    Every article (webpage) has its line, with icon, name, local and online link icons, local language versions, remote language version and number of online views.

    Articles (webpages) are loaded from the directory you can set in settings window.

    Doubleclick article (webpage) line in the list, to open it.


    back to top
  4. Article is name for the hole set of data, that are loaded and saved - XHTML, JPG, CSS and TXT files. Articles (sometimes also called webpages) are created and edited in editor window. On next picture, you can see 4 sections of editor window, with article (webpage) settings on left and article text/code and preview on right site.

    Editor Layout
    • SETTINGS of article section is for setting name, activation and deactivation date, keywords and column data of the article. Column and sub-column can be very usefull - using same column for more articles, you make a group of articles. And your website can automaticaly generate menus from column and subcolumn groups.
    • PICTURES of article here you can see article pictures. To add them, click + button or drop files on editor window - they will be resized automaticaly. You can import JPG (JPEG) and PNG files (non-transparent), with QuickTime installed, you can import any of files supported by QuickTime (TIFF, PSD, PDF, EPS, ...).
      Intro picture is picture, that will be used when diplaying list of articles (websites) - mostly if you use your website as portal. If none is set, first of article pictures will be used. If you have no pictures in your article, some of the site default pictures will be used.
      Editor - Code mode of Text section
    • TEXT of article is for changing text content of the article. You can decide between using Styled Text mode or advanced users will enjoy the Code mode. In the Styled Text mode, you can export and import styled text from RTF files using options in contextual menu (right click).
      There are 3 ways, to place picture into text:
      1. Drag picture from Pictures list and drop it where you want in the text.
      2. Use contextual menu and select from the list of pictures (right click).
      3. Write <PIC#> where # is ID of picture, in the Picture list (eg. <PIC4>). By default pictures are centered. To align pictures, use <PIC#_L> to align on left, <PIC#_R> to align on right and <PIC#_P> (P as plain) to use default alignment.
    • PREVIEW of article is great for fast preview of the final look of the content part of the website. You can experiment with adding pictures, formating text, changing code and preview the result, without need to wait or save.

    Note: While conversion from Styled text mode to Code mode translates all formating into HTML, conversion from Code to Styled text mode, can cause in code loss. Bold, italic, color and links marks are translated correctly, but other will be probably lost. This is done, because it's not possible to translate more complex HTML and CSS formatings into simple RTF-like Text format, which is used by Styled text mode.


    back to top
  5. First, select article in the List of articles window. Sending and downloading selected article is very easy. Can be done in 2 clicks.

    Sending articleClick Send button or choose Send from the Internet menu.

    Now select:
    • if you want to update existing article (you can update only articles you already have online),
    • or you want to send article as new,
    • or you can send all your local articles (they will be send as new, or updated if possible).

    Downloading articleClick Download button or choose Download from the Internet menu.

    Now select:
    • if you want to download latest version of article from internet and update you local version (you can update only paired articles),
    • or you want to download article from internet and save it as new,
    • or you can download all your online articles (they will be downloaded as new and paired, or updated if possible).

    Pairing articleTo "Pair article", means you will tell Publisher, which local article belongs to which online article. This can be usefull, if id.txt file of article was lost somehow and you want to update your article.

    You have to have some article selected first. Then click Pair button or choose Pair from the Internet menu.

    Choose from the list of online articles (you will see preview of its text) and click OK to pair article.


    Deleting articleClick Delete button or choose Delete from the Internet menu.

    Now select:
    • if you want to delete local article from your computer,
    • or you want to delete article from website (only with paired articles, local article must be selected),
    • or you can delete article from both - computer and website (only with paired articles, local article must be selected).

    CompletedProgress of actions like sending and downloading article(s), can be watched in this status part of window. It's displayed as actions are executed.

    When everything is done, "Close Window" button is activated. Click it to close window and refresh the list. If you don't click it, window will be closed anyway after few seconds.


    back to top
  6. Copyright

    Created by Marcel Zúbrik. All rights reserved © 2005-2007 Marcel Zúbrik - cw. If not written else, all files are property of Marcel Zúbrik and his creative workshop.

    Licence

    Publisher is free to use and can be distributed for free to other websites. Publisher is trying to be simple and universal, but is still under development. You can use it, only if you agree, that developer takes no responsibility for your data and how you use this application. Developer declares, that sofware doesn't contain any spyware code and it don't collect any data about user and his system, except data necessary for making connection to users account (fullname, login, password, language) and managing article data.

    Known problems:

    • Syntax highliting is not working properly in Windows version.
    • On Mac OS X there was sometimes problem with Quick HTML preview - not displaying preview or cannot be scrolled. Was not able to find any key for these unexpected behaviours. Usualy was solved by saving article, closing and reopening application and article.
    back to top
  7. Localization

    Whian.net applications can be localized into other languages, creating only their external files, that contain text in that language.
    In present, Whian.net applications are localized to 2 languages - Slovak and English. Please, let us know, if you make new/better translation, so we can include it in public distribution from www.whian.net.
    Here is short description, where to find files for translation in both, Mac OS X and Windows.

    Mac OS X

    In Mac OS X, placement of localization files respects structure of Mac OS X applications.
    To reach them, select aplication icon and use right click (or CTRL+click). Select "Show Package Contents" from contextual menu, that pops up. Now you're inside application, go into Contents -> Resources. There you can find directories with ".proj" extension, with language code before it ("en" for english, "sk" for slovak). Inside them, you find plain text file "Localizable.strings". You can open it with any text editor (eg. TextEdit) and use it for translation. The result should be new ".lproj" directory with "Localizable.strings" inside and 2 letter code before ".lproj" extension.
    You can also remove unwanted translation folders and make application to use only the translation you want.

    Windows

    In Windows, ".mo" files are used for localizing application strings.
    To reach them, open Resources directory. Inside it, you can find files with ".mo" extension, with language code before it ("en" for english, "sk" for slovak). To edit ".mo" files, it should be possible to use poEdit, however we never tried to edit ".mo" files with it. The result should be new ".mo" file with 2 letter code before ".mo" extension.
    You can also remove unwanted translation ".mo" files and make application to use only the translation you want.


Publisher User's Guide version 2007-06-22 r1