Merge pull request #345 from plone/moreshots

adding more robotshots, updating for p5
plone · Aug 19, 2015 · 03f43cb · 03f43cb
2 parents 5a784b2 + 6293f37
commit 03f43cb
Show file tree

Hide file tree

Showing 19 changed files with 526 additions and 489 deletions.
diff --git a/_robot.rst b/_robot.rst
@@ -15,7 +15,7 @@
 
    ${FIXTURE}  plone.app.robotframework.PLONE_ROBOT_TESTING
    @{DIMENSIONS}  1024  768
-   @{APPLY_PROFILES}  plone.app.contenttypes:default
+   @{APPLY_PROFILES}  plone.app.contenttypes:plone-content
 
 
    *** Keywords ***

diff --git a/_robot_anon.rst b/_robot_anon.rst
@@ -0,0 +1,47 @@
+.. code:: robotframework
+
+   *** Settings ***
+
+   Resource  plone/app/robotframework/server.robot
+   Resource  plone/app/robotframework/keywords.robot
+   Resource  Selenium2Screenshots/keywords.robot
+
+   Library  OperatingSystem
+
+   Suite Setup  Run keywords  Suite Setup  Test Setup
+   Suite Teardown  Run keywords  Test teardown  Suite Teardown
+
+   *** Variables ***
+
+   ${FIXTURE}  plone.app.robotframework.PLONE_ROBOT_TESTING
+   @{DIMENSIONS}  1024  768
+   @{APPLY_PROFILES}  plone.app.contenttypes:plone-content
+
+
+   *** Keywords ***
+
+   Suite Setup
+       Run keyword if  not sys.argv[0].startswith('bin/robot')
+       ...             Setup Plone site  ${FIXTURE}
+       Run keyword if  sys.argv[0].startswith('bin/robot')
+       ...             Open test browser
+       Run keyword and ignore error  Set window size  @{DIMENSIONS}
+
+   Test Setup
+       Import library  Remote  ${PLONE_URL}/RobotRemote
+
+       Run keyword if  sys.argv[0].startswith('bin/robot')
+       ...             Remote ZODB SetUp  ${FIXTURE}
+
+       ${language} =  Get environment variable  LANGUAGE  'en'
+       Set default language  ${language}
+
+   Test Teardown
+       Run keyword if  sys.argv[0].startswith('bin/robot')
+       ...             Remote ZODB TearDown  ${FIXTURE}
+
+   Suite Teardown
+       Run keyword if  not sys.argv[0].startswith('bin/robot')
+       ...             Teardown Plone Site
+       Run keyword if  sys.argv[0].startswith('bin/robot')
+       ...             Close all browsers
diff --git a/appendices/glossary.rst b/appendices/glossary.rst
@@ -548,4 +548,7 @@ It incorporates the original `glossary on plone.org <https://plone.org/documenta
         Buildout is a Python-based build system for creating, assembling and deploying applications from multiple parts, some of which may be non-Python-based. It lets you create a buildout configuration and reproduce the same software later. See `buildout.org <http://www.buildout.org/en/latest/>`_
 
     browserview
-         Plone uses a view pattern to output dynamically generated HTML pages. Views are the basic elements of modern Python web frameworks. A view runs code to setup Python variables for a rendering template. Output is not limited to HTML pages and snippets, but may contain JSON, file download payloads, or other data formats. See :doc:`views </develop/plone/views/browserviews>`
+         Plone uses a view pattern to output dynamically generated HTML pages. Views are the basic elements of modern Python web frameworks. A view runs code to setup Python variables for a rendering template. Output is not limited to HTML pages and snippets, but may contain JSON, file download payloads, or other data formats. See :doc:`views </develop/plone/views/browserviews>`
+
+    toolbar
+         Plone uses a toolbar to have quick access to the content management functions. On a standard instance, this will appear on the left of your screen. However, your site administrator might change this to have a horizontal layout, and it will appear hidden at first when using a smaller-screen device like a phone or tablet.
diff --git a/working-with-content/adding-content/adding-events.rst b/working-with-content/adding-content/adding-events.rst
@@ -7,10 +7,7 @@ Plone web sites have a built-in system for managing and showing calendar events.
 
 Use the *Add new...* menu for a folder to add an event:
 
-.. replaces ../../_static/copy_of_addnewmenu.png
-.. figure:: ../../_robot/adding-events_add-menu.png
-   :align: center
-   :alt: add-new-menu.png
+
 
 .. code:: robotframework
    :class: hidden
@@ -33,13 +30,15 @@ Use the *Add new...* menu for a folder to add an event:
        ...  css=div.plone-toolbar-container
        ...  css=#plone-contentmenu-factories ul
 
+.. replaces ../../_static/copy_of_addnewmenu.png
+.. figure:: ../../_robot/adding-events_add-menu.png
+   :align: center
+   :alt: add-new-menu.png
+
 
 Select **Event** from the drop-down menu, and you'll see the rather large *Add Event* panel:
 
-.. replaces: ../../_static/addevent.png
-.. figure:: ../../_robot/adding-events_add-form.png
-   :align: center
-   :alt:
+
 
 .. code:: robotframework
    :class: hidden
@@ -57,6 +56,11 @@ Select **Event** from the drop-down menu, and you'll see the rather large *Add E
        ...  ${CURDIR}/../../_robot/adding-events_add-form.png
        ...  css=#content
 
+.. replaces: ../../_static/addevent.png
+.. figure:: ../../_robot/adding-events_add-form.png
+   :align: center
+   :alt: Adding events form
+
 From the top, we have the following fields:
 
 -  *Title* - **REQUIRED**
@@ -93,10 +97,3 @@ For repeating events, use the "recurrence" link. You can set when, and how often
 .. note::
 
    **IMPORTANT:** Your event will not show on the main web site calendar until it has been **published**.
-
-
-
-
-.. robotframework::
-   :creates: ../../_robot/adding-events_add-menu.png
-             ../../_robot/adding-events_add-form.png
diff --git a/working-with-content/adding-content/adding-files.rst b/working-with-content/adding-content/adding-files.rst
@@ -7,10 +7,7 @@ Files of various types can be uploaded to Plone web sites.
 
 Choose file in the *Add new...* menu for a folder to upload a file:
 
-.. replaces ../../_static/copy_of_addnewmenu.png
-.. figure:: ../../_robot/adding-files_add-menu.png
-   :align: center
-   :alt: add-new-menu.png
+
 
 .. code:: robotframework
    :class: hidden
@@ -32,12 +29,14 @@ Choose file in the *Add new...* menu for a folder to upload a file:
        ...  css=div.plone-toolbar-container
        ...  css=#plone-contentmenu-factories ul
 
+.. replaces ../../_static/copy_of_addnewmenu.png
+.. figure:: ../../_robot/adding-files_add-menu.png
+   :align: center
+   :alt: add-new-menu.png
+
 Select **File** from the drop-down menu, and you'll see the *Add File* panel:
 
-.. replaces: ../../_static/addfile.png
-.. figure:: ../../_robot/adding-files_add-form.png
-   :align: center
-   :alt:
+
 
 .. code:: robotframework
    :class: hidden
@@ -55,6 +54,11 @@ Select **File** from the drop-down menu, and you'll see the *Add File* panel:
        ...  ${CURDIR}/../../_robot/adding-files_add-form.png
        ...  css=#content
 
+.. replaces: ../../_static/addfile.png
+.. figure:: ../../_robot/adding-files_add-form.png
+   :align: center
+   :alt:
+
 Click the *Browse* button to navigate to the file you want to upload from your local computer. Provide a title (you can use the same file name used on your local computer if you want).
 Provide a *description* if you want. When you click the save button the file will be uploaded to the folder.
 
@@ -67,6 +71,3 @@ They will appear by name in lists and will be available for download if clicked.
 There are specialized add-on tools for Plone web sites that search the content of files, or can provide a preview of for instance PDF or Office files.
 If you are interested in this functionality, ask your Plone web site administrator.
 
-.. robotframework::
-   :creates: ../../_robot/adding-files_add-menu.png
-             ../../_robot/adding-files_add-form.png
diff --git a/working-with-content/adding-content/adding-folders.rst b/working-with-content/adding-content/adding-folders.rst
@@ -12,10 +12,7 @@ In Plone folders are essentially used the same way, except that they are created
 Folders are added by clicking the **Add new...** drop-down menu.
 Select **Folder** from the menu:
 
-.. replaces: /_static/add-item-menu-folder.png
-.. figure:: ../../_robot/adding-folders_add-menu.png
-   :align: center
-   :alt: add-new-menu.png
+
 
 .. code:: robotframework
    :class: hidden
@@ -38,14 +35,13 @@ Select **Folder** from the menu:
        ...  css=div.plone-toolbar-container
        ...  css=#plone-contentmenu-factories ul
 
-
+.. replaces: /_static/add-item-menu-folder.png
+.. figure:: ../../_robot/adding-folders_add-menu.png
+   :align: center
+   :alt: add-new-menu.png
 
 You should now see the *Add Folder* screen:
 
-.. replaces: /_static/addfolder.png
-.. figure:: ../../_robot/adding-folders_add-form.png
-   :align: center
-   :alt:
 
 .. code:: robotframework
    :class: hidden
@@ -63,6 +59,11 @@ You should now see the *Add Folder* screen:
        ...  ${CURDIR}/../../_robot/adding-folders_add-form.png
        ...  css=#content
 
+.. replaces: /_static/addfolder.png
+.. figure:: ../../_robot/adding-folders_add-form.png
+   :align: center
+   :alt:
+
 
 Fill in the **Title**, which is required, as indicated by the red dot.
 The **Summary** is optional; you can always come back to the edit panel if you need to add a description of the folder.
@@ -87,6 +88,3 @@ We will cover these tabs in another section of this user manual.
 Be sure to click **Save** at the bottom of the page when you are finished.
 This will complete the folder creation process.
 
-.. robotframework::
-   :creates: ../../_robot/adding-folders_add-menu.png
-             ../../_robot/adding-folders_add-form.png
diff --git a/working-with-content/adding-content/adding-images.rst b/working-with-content/adding-content/adding-images.rst
@@ -14,11 +14,6 @@ Adding images to a Plone web site is a basic task that may involve a little work
 
 When you are ready to upload an image, use the *Add new...* drop-down menu.
 
-.. replaces: /_static/add-item-menu-image.png
-.. figure:: ../../_robot/adding-images_add-menu.png
-   :align: center
-   :alt: add-new-menu.png
-
 .. code:: robotframework
    :class: hidden
 
@@ -41,13 +36,13 @@ When you are ready to upload an image, use the *Add new...* drop-down menu.
        ...  css=#plone-contentmenu-factories ul
 
 
+.. replaces: /_static/add-item-menu-image.png
+.. figure:: ../../_robot/adding-images_add-menu.png
+   :align: center
+   :alt: add-new-menu.png
 
-After clicking to add an **Image**, you'll see the *Add Image* panel:
 
-.. replaces: /_static/addimage.png
-.. figure:: ../../_robot/adding-images_add-form.png
-   :align: center
-   :alt:
+After clicking to add an **Image**, you'll see the *Add Image* panel:
 
 .. code:: robotframework
    :class: hidden
@@ -65,7 +60,10 @@ After clicking to add an **Image**, you'll see the *Add Image* panel:
        ...  ${CURDIR}/../../_robot/adding-images_add-form.png
        ...  css=#content
 
-
+.. replaces: /_static/addimage.png
+.. figure:: ../../_robot/adding-images_add-form.png
+   :align: center
+   :alt: Adding images form
 
 The Title and Description fields (field, as in "data input field") are there, as with adding a Folder, and at the bottom there is a place to upload an image.
 Let's look at the three input fields individually:
@@ -84,7 +82,3 @@ You'll have to wait a few seconds for the upload to complete.
 A preview of the uploaded image will be shown when the upload has finished.
 
 Images and files that you upload into Plone have their IDs (URLs) based on the title that you give to the image (instead of the file name of the image or file). However, if you leave the title empty, the name of the item will default to the name of the file.
-
-.. robotframework::
-   :creates: ../../_robot/adding-images_add-menu.png
-             ../../_robot/adding-images_add-form.png
diff --git a/working-with-content/adding-content/adding-links.rst b/working-with-content/adding-content/adding-links.rst
@@ -8,11 +8,6 @@ Having links as discrete items lets you do things like organizing them in folder
 
 Add a link by clicking the menu choice in the *Add new...* menu:
 
-.. replaces: /_static/copy_of_addnewmenu.png
-.. figure:: ../../_robot/adding-links_add-menu.png
-   :align: center
-   :alt: add-new-menu.png
-
 .. code:: robotframework
    :class: hidden
 
@@ -34,14 +29,13 @@ Add a link by clicking the menu choice in the *Add new...* menu:
        ...  css=div.plone-toolbar-container
        ...  css=#plone-contentmenu-factories ul
 
+.. replaces: /_static/copy_of_addnewmenu.png
+.. figure:: ../../_robot/adding-links_add-menu.png
+   :align: center
+   :alt: add-new-menu.png
 
 You will see the Add*Link* panel:
 
-.. freplaces: /_static/addlink.png
-.. figure:: ../../_robot/adding-links_add-form.png
-   :align: center
-   :alt:
-
 .. code:: robotframework
    :class: hidden
 
@@ -58,6 +52,11 @@ You will see the Add*Link* panel:
        ...  ${CURDIR}/../../_robot/adding-links_add-form.png
        ...  css=#content
 
+.. replaces: /_static/addlink.png
+.. figure:: ../../_robot/adding-links_add-form.png
+   :align: center
+   :alt: Adding links form
+
 Good titles for links are important, because the titles will show up in lists of links, and because there tend to be large numbers links held in a folder or collection.
 
 Paste the web address in the URL field or type it in.
@@ -72,7 +71,3 @@ status, or permissions.
 -  **If you have the ability to edit the link object**, when you click on the link object you'll be taken to the object itself so that you can edit it (otherwise you'd be taken to the link's target and could never get to the edit tab!)
 -  **If you don't have the ability to edit the link object**, when you click on the link object you'll be taken to the target of the link object. Likewise, if you enter the web address of the link object
    directly in your browser, you'll be taken directly to the link's target. The link object in this case acts as a *redirect*.
-
-.. robotframework::
-   :creates: ../../_robot/adding-links_add-menu.png
-             ../../_robot/adding-links_add-form.png
diff --git a/working-with-content/adding-content/adding-new-content.rst b/working-with-content/adding-content/adding-new-content.rst
@@ -9,11 +9,6 @@ A general overview of how to add new content items in Plone, including definitio
 
 New content items are added via the **Add New . . .** drop-down menu:
 
-.. replaces: /_static/copy_of_addnewmenu.png
-.. figure:: ../../_robot/adding-content_add-menu.png
-   :align: center
-   :alt: add-new-menu.png
-
 .. code:: robotframework
    :class: hidden
 
@@ -35,7 +30,10 @@ New content items are added via the **Add New . . .** drop-down menu:
        ...  css=div.plone-toolbar-container
        ...  css=#plone-contentmenu-factories ul
 
-
+.. replaces: /_static/copy_of_addnewmenu.png
+.. figure:: ../../_robot/adding-content_add-menu.png
+   :align: center
+   :alt: add-new-menu.png
 
 Adding content in Plone is done *placefully*, which means you should navigate to the section of your Plone website where you want the new content to reside **before** you use the **Add New . . .** drop-down menu.
 You can of course cut, copy, and paste content items from one section to another if needed at any later time.
@@ -54,7 +52,7 @@ Event
     This content type has a function which allows the site visitor to add the event to their desktop calendar. This includes applications such as: Google Calendar, Outlook, Sunbird and others.
     To add a single event to your calendar, click on the iCal link next to the "Add event to calendar" text in the main view of the event item.
 
-    .. figure:: /_static/events-summary-chart.png
+    .. figure:: ../../_static/events-summary-chart.png
        :align: center
        :alt: events-summary-chart.png
 
@@ -117,6 +115,3 @@ Descriptions are often used to conjunction with a variety of Folder and Collecti
 The Description also appears in search results via Plone's native search engine.
 
 The Description is just plain text, without any form of mark-up. This is to keep it inline with the :term:`Dublin Core` standard, a long-established way of categorizing information.
-
-.. robotframework::
-   :creates: ../../_robot/adding-content_add-menu.png