Version 10 (modified by 15 years ago) ( diff ) | ,
---|
- Improving Boost Docs
- About this project
- Boost docs repository
- Unified look & feel project
- Docs translations project
- Glue docs project
- Standard C++ Library Docs
- Documentation Best Practices
- Subprojects
- Boost.DocTest
- Boost HTML stylesheet
- Boost Kate support
- Boost PDF stylesheet
- Boost specific WikiMacros
- Boost Trac stylesheet
- Boost.Build support for doc tools
- Boostscript
- Google Search Box project
- HTML to docbook
- Improving Boostbook
- Quickbook WikiProcessor
- Quickbook source stylesheet
- SVG icons set project
- Syntax highlighting project
- Trac Syntax Coloring
- Browser Testing Chart
- Logo Playground
The purpose of this sub project is to find SVG Icons to use in the generation of Boost's documentation.
Key requirements include:
- Have a compatible license type for use within Boost.
- Provide Icon's that look good! By:
- Using consistent themed icon's for logically grouped icon's
- Using icons that are visually easy to work out what they mean (this is particularly important for the Admonitions)
License Type
To 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.
To find the thread in the archive search for "Acceptable Licenses for Boost-Doc SVG Icons" sent by Peter Foley at 28 Jun 06 1818.
Rationale behind choosing Scalable Vector Graphics (SVG) Icons
See this Wikipedia article: http://en.wikipedia.org/wiki/SVG
Key Points:
- It is an open standard
- It is easy to convert to other formats
- SVG files scale really well
Currently proposed Icons
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/
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.
Note: All the below images can be located off this page: http://tango.freedesktop.org/Tango_Icon_Gallery
Navigation Icons
The purpose of these icons are to navigate through the produced documentation.
Next Page:
Previous Page:
Chapter Start:
Home Page:
Comments:
(See this thread for more information: http://tinyurl.com/yrrmgd)
- Currently the preference is to keep the navigation icons green. This will match the current proposed colour scheme (green).
- Although the Home page icon is not green it was suggested that this would be good to more visually stand out from the arrows.
Admonitions
Note:
Comments:
- 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.
Tip:
Comments:
- 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!
Important:
Comments:
- I think that this one looks better for a caution icon.
Caution:
Waring:
General Comments
By: Matias Capeletto on Sun, 24 Jun 2007 10:45:55 -0300
mmm... I think a common sense rationale for some of these admonitions will be:
Warning ---> Yellow
Caution ---> Red
Active Developers
- Improving Boost Docs
- About this project
- Boost docs repository
- Unified look & feel project
- Docs translations project
- Glue docs project
- Standard C++ Library Docs
- Documentation Best Practices
- Subprojects
- Boost.DocTest
- Boost HTML stylesheet
- Boost Kate support
- Boost PDF stylesheet
- Boost specific WikiMacros
- Boost Trac stylesheet
- Boost.Build support for doc tools
- Boostscript
- Google Search Box project
- HTML to docbook
- Improving Boostbook
- Quickbook WikiProcessor
- Quickbook source stylesheet
- SVG icons set project
- Syntax highlighting project
- Trac Syntax Coloring
- Browser Testing Chart
- Logo Playground
Attachments (23)
-
info_v1.png
(1.7 KB
) - added by 15 years ago.
Custom Icon - Info, Blue Circle, Letter i
-
info_v2.png
(2.3 KB
) - added by 15 years ago.
Custom Icon - Info, Blue Circle, Magnifying Glass
-
tip_v1.png
(2.5 KB
) - added by 15 years ago.
Custom Icon - Tip, Black Circle, Light Globe (on)
-
tip_v2.png
(2.5 KB
) - added by 15 years ago.
Custom Icon - Tip, Light Globe (on)
-
circle_blue_i_tip.png
(1.7 KB
) - added by 15 years ago.
Circle, Colour Blue, Letter i
-
circle_green_i_tip.png
(1.6 KB
) - added by 15 years ago.
Circle, Colour Green, Letter i
-
circle_blue_light_on.png
(2.5 KB
) - added by 15 years ago.
Circle, Colour Blue, light on
-
circle_green_light_on.png
(2.3 KB
) - added by 15 years ago.
Circle, Colour Green, light on
-
circle_blue_mag_page_tip.png
(2.2 KB
) - added by 15 years ago.
Circle, Colour Blue, Magnifying Glass and Page
-
circle_green_mag_page_tip.png
(2.0 KB
) - added by 15 years ago.
Circle, Colour Green, Magnifying Glass and Page
-
circle_blue_pen_page_tip.png
(2.2 KB
) - added by 15 years ago.
Circle, Colour Blue, Pen and Page
-
circle_green_pen_page_tip.png
(2.1 KB
) - added by 15 years ago.
Circle, Colour Green, Pen and Page
-
circle_black_i_bw.png
(692 bytes
) - added by 15 years ago.
Circle, Black and White, Letter i
-
circle_black_light_bw.png
(1.1 KB
) - added by 15 years ago.
Circle, Black and White, Light Globe
-
hexagon_black_stop_bw.png
(1.6 KB
) - added by 15 years ago.
Hexagon, Black and White, Word Stop
-
triangle_black_exclamation_bw.png
(1.5 KB
) - added by 15 years ago.
Triangle, Black and White, Exclamation Mark
-
hexagon_red_stop.png
(2.1 KB
) - added by 15 years ago.
Hexagon, Colour Red, Word Stop
-
triangle_orange_exclamation.png
(1.4 KB
) - added by 15 years ago.
Triangle, Colour Orange, Exclamation Mark
-
square_yellow_star.png
(1.3 KB
) - added by 15 years ago.
Square, Yellow, Star
-
square_black_star.png
(1.5 KB
) - added by 15 years ago.
Square, Black, Star
-
circle_black_light_on.png
(2.7 KB
) - added by 15 years ago.
Circle, Black, light on
-
square_black_star_bw.png
(872 bytes
) - added by 15 years ago.
Square, Black and White, Star
-
circle_black_pen_page_bw.png
(1.6 KB
) - added by 15 years ago.
Circle, Black and White, Pen Notebook
Download all attachments as: .zip