Changes between Version 12 and Version 13 of SvgIconsSetProject


Ignore:
Timestamp:
Jul 4, 2007, 12:11:01 PM (15 years ago)
Author:
Peter Foley
Comment:

Updated the layout of information so it is easier to see the icons

Legend:

Unmodified
Added
Removed
Modified

  • SvgIconsSetProject

    v12 v13  
    3333[[Image(ImprovingBoostDocsSubprojects:svg_icons_set.png,nolink)]]
    3434
    35 The purpose of this sub project is to find SVG Icons to use in the generation of Boost's documentation.
     35The purpose of this sub project is to find SVG Icons for use in the generation of Boost's documentation.
    3636
    37 Key requirements include:
    38  * Have a compatible license type for use within Boost.
     37Key requirements for the icons include:
     38 * A compatible license type for use within Boost.
    3939 * Provide Icon's that look good! By:
    40    * Using consistent themed icon's for logically grouped icon's
    41    * Using icons that are visually easy to work out what they mean (this is particularly important for the Admonitions)
     40   * Using icons that have a consistent theme based on their logical function (eg navigation icons should look similar);
     41   * Using icons that easily convey their function (this is particularly important for the Admonitions icons).
    4242
    4343== License Type ==
     44
     45''Currently we are soliciting feedback from the boost community on a preference for the license type.''
    4446
    4547To assist with setting the expectation for this project (ie use existing icons under an open source license or create the icons and license them under the Boost Software License, http://tinyurl.com/2xood5) I have sent an e-mail to the Boost Developers list and the Boost Documentation list seeking feedback on the license type.
    … …  
    4951== Rationale behind choosing Scalable Vector Graphics (SVG) Icons ==
    5052
    51 See this Wikipedia article: http://en.wikipedia.org/wiki/SVG
    52 
    5353Key Points:
    5454 * It is an open standard
    … …  
    5656 * SVG files scale really well
    5757
    58 == Currently proposed Icons ==
     58For more information on the benefits of using SVG based images see this Wikipedia article: http://en.wikipedia.org/wiki/SVG
    5959
    60 Currently the Tango Desktop project (http://tinyurl.com/23tspp) appears to provide promising icons.  These icons are licensed under the Creative Commons Attribution Share-Alike license, http://creativecommons.org/licenses/by-sa/2.5/
     60''Note:'' It is worth stating that there are various tools/utilties that can easily convert to the PNG format, http://en.wikipedia.org/wiki/Png!.  This is required as not all web browsers support the SVG format natively.
    6161
    62 Each icon in this set provides an SVG file.  From this we can easily convert it to a PNG, http://en.wikipedia.org/wiki/Png file of the appropriate size.
     62== Currently Proposed Icons ==
    6363
    64 ''Note:''  All the below images can be located off this page: http://tango.freedesktop.org/Tango_Icon_Gallery
     64This area will provide a central location to show each of the proposed icons and allow the Boost community the opportunity to comment on them.
     65
     66Currently proposed icon sets include:
     67 * [http://tango.freedesktop.org/ The Tango Desktop project] which provides icons using the SVG format.  This project is licensed under the [http://creativecommons.org/licenses/by-sa/2.5/ Creative Commons Attribution Share-Alike license].
     68
     69'''General Icon requirements''' that various Boost Community members have requested:
     70 *  The icons should look good both in colour and in black and white (for printing).  This is specifically for the Admonitions.
    6571
    6672=== Navigation Icons ===
    6773
    68 The purpose of these icons are to navigate through the produced documentation.
     74These icons will be used to allow the user to navigate through the produced documentation.
    6975
    70 '''Next Page:'''    [[Image(http://tango.freedesktop.org/static/cvs/tango-icon-theme/22x22/actions/go-next.png,nolink)]] [[BR]]
    71 '''Previous Page:'''    [[Image(http://tango.freedesktop.org/static/cvs/tango-icon-theme/22x22/actions/go-previous.png,nolink)]] [[BR]]
    72 '''Chapter Start:'''    [[Image(http://tango.freedesktop.org/static/cvs/tango-icon-theme/22x22/actions/go-up.png,nolink)]] [[BR]]
    73 '''Home Page:'''    [[Image(http://tango.freedesktop.org/static/cvs/tango-icon-theme/22x22/actions/go-home.png,nolink)]] [[BR]]
     76'''Navigation Icon requirements''' that various Boost Community members have requested:
     77 *  Currently the preference is to keep the navigation icons green.  This will match the current proposed colour scheme. (See http://tinyurl.com/yrrmgd)
     78 *  Although the Tango Home page icon is not green it was suggested that this would be good to more visually stand out from the arrows. (See http://tinyurl.com/yrrmgd)
    7479
    75 ''Comments:'' [[BR]]
    76 (See this thread for more information: http://tinyurl.com/yrrmgd)
     80{{{
     81#!rst
    7782
    78  *  Currently the preference is to keep the navigation icons green.  This will match the current proposed colour scheme (green).
    79  *  Although the Home page icon is not green it was suggested that this would be good to more visually stand out from the arrows.   
     83==================  ==================  ==================  ==================  ==================  ================
     84**Icon Set Name**   **Previous Page**   **Chapter Start**   **Index Page**      **Next Page**       **License Type**
     85==================  ==================  ==================  ==================  ==================  ================
     86|tango_set|_        |tango_prev| |SVG|  |tango_chap| |SVG|  |tango_indx| |SVG|  |tango_next| |SVG|  |ccasal|_
     87==================  ==================  ==================  ==================  ==================  ================
     88
     89.. Set Name - Tango
     90
     91.. |tango_set| replace:: *Tango Desktop Project*
     92.. _tango_set: http://tinyurl.com/23tspp/
     93.. |tango_prev| image:: http://tango.freedesktop.org/static/cvs/tango-icon-theme/22x22/actions/go-previous.png
     94.. |tango_chap| image:: http://tango.freedesktop.org/static/cvs/tango-icon-theme/22x22/actions/go-up.png
     95.. |tango_indx| image:: http://tango.freedesktop.org/static/cvs/tango-icon-theme/22x22/actions/go-home.png
     96.. |tango_next| image:: http://tango.freedesktop.org/static/cvs/tango-icon-theme/22x22/actions/go-next.png
     97
     98.. License Types
     99.. |ccasal| replace:: *Creative Commons Attribution Share-Alike license*
     100.. _ccasal: http://creativecommons.org/licenses/by-sa/2.5/
     101
     102.. Image Type
     103.. |SVG| replace:: *(svg available)*
     104.. |PNG| replace:: *(png available)*
     105
     106}}}
     107
    80108
    81109=== Admonitions ===
    82110
    83 '''Note:''' [[Image(http://tango.freedesktop.org/static/cvs/tango-icon-theme/22x22/actions/system-search.png,nolink)]] [[BR]]
    84 
    85 ''Comments:'' [[BR]]
    86  * It was suggested that the magnifing glass would not be a good choice.  Another option is a Blue circle with the letter i in it.
    87 
    88 '''Tip:''' [[Image(http://tango.freedesktop.org/static/cvs/tango-icon-theme/22x22/status/dialog-information.png,nolink)]] [[BR]]
    89 
    90 ''Comments:'' [[BR]]
    91  * The response so far suggests that this is a good icon.  There was the suggestion that it would look better if the light was switched on!
    92 
    93 '''Important:''' [[Image(http://tango.freedesktop.org/static/cvs/tango-icon-theme/22x22/status/dialog-warning.png,nolink)]] [[BR]]
    94 
    95 ''Comments:'' [[BR]]
    96  * I think that this one looks better for a caution icon.
    97 
    98 '''Caution:''' [[Image(http://tango.freedesktop.org/static/cvs/tango-icon-theme/22x22/status/dialog-error.png,nolink)]] [[BR]]
    99 
    100 
    101 '''Waring:''' [[Image(http://tango.freedesktop.org/static/cvs/tango-icon-theme/22x22/actions/process-stop.png,nolink)]] [[BR]]
    102 
    103 ''General Comments''
     111'''Admonition Icon requirements''' that various Boost Community members have requested:
    104112
    105113By: Matias Capeletto on Sun, 24 Jun 2007 10:45:55 -0300
    … …  
    109117Warning ---> Yellow [[BR]]
    110118Caution  ---> Red
     119
     120
     121{{{
     122#!rst
     123==================  ==================  ==================  ==================  ==================  ==================  ================
     124**Icon Set Name**   **Note**            **Tip**             **Important**       **Caution**         **Waring**          **License Type**
     125==================  ==================  ==================  ==================  ==================  ==================  ================
     126|tango_set|_        |tango_note| |SVG|  |tango_tip| |SVG|   |tango_impt| |SVG|  |tango_cutn| |SVG|  |tango_warn| |SVG|  |ccasal|_
     127==================  ==================  ==================  ==================  ==================  ==================  ================
     128
     129.. |tango_set| replace:: *Tango Desktop Project*
     130.. _tango_set: http://tinyurl.com/23tspp/
     131.. |tango_note| image:: http://tango.freedesktop.org/static/cvs/tango-icon-theme/22x22/actions/system-search.png
     132.. |tango_tip| image:: http://tango.freedesktop.org/static/cvs/tango-icon-theme/22x22/status/dialog-information.png
     133.. |tango_impt| image:: http://tango.freedesktop.org/static/cvs/tango-icon-theme/22x22/status/dialog-warning.png
     134.. |tango_cutn| image:: http://tango.freedesktop.org/static/cvs/tango-icon-theme/22x22/status/dialog-error.png
     135.. |tango_warn| image:: http://tango.freedesktop.org/static/cvs/tango-icon-theme/22x22/actions/process-stop.png
     136
     137.. License Types
     138.. |ccasal| replace:: *Creative Commons Attribution Share-Alike license*
     139.. _ccasal: http://creativecommons.org/licenses/by-sa/2.5/
     140
     141.. Image Type
     142.. |SVG| replace:: *(svg available)*
     143.. |PNG| replace:: (png available)
     144
     145}}}
     146
     147'''Comments so far:'''
     148 * ''Tango Desktop Project''
     149   *  Note      - It was suggested that the magnifing glass would not be a good choice.  Another option is a Blue circle with the letter i in it.
     150   *  Tip       - The response so far suggests that this is a good icon.  There was the suggestion that it would look better if the light was switched on!
     151   *  Important - I think that this one looks better for a caution icon.
    111152
    112153----