Integrating Qt Examples: Difference between revisions

From Qt Wiki
Jump to navigation Jump to search
No edit summary
 
No edit summary
Line 1: Line 1:
'''English''' [[Integrating-Qt-Examples Russian|Русский]] [[Integrating-Qt-Examples-Spanish|Spanish]] [[Integrating-Qt-Examples Italian|Italian]] [[Integrating-Qt-Examples-SimplifiedChinese|简体中文]]
'''English''' [[Integrating Qt Examples_Russian|Русский]] [[Integrating Qt Examples Spanish|Spanish]] [[Integrating Qt Examples_Italian|Italian]] [[Integrating Qt Examples SimplifiedChinese|简体中文]]


=Integrating Qt Examples=
= Integrating Qt Examples =


Once you have written an example (see [[Writing-Qt-Examples|Writing Qt Examples]]) and documented it, you need to do the following things to ensure that it will work correctly within Qt’s build and documentation systems:
Once you have written an example (see [[Writing Qt Examples]]) and documented it, you need to do the following things to ensure that it will work correctly within Qt's build and documentation systems:


# Ensure that the example’s .pro file contains the standard rules for installation.
# Ensure that the example's .pro file contains the standard rules for installation.
# Add the example directory to the parent directory’s .pro file. Make sure that the example compiles when ''make sub-examples'' is run.
# Add the example directory to the parent directory's .pro file. Make sure that the example compiles when ''make sub-examples'' is run.
# Add documentation for the example to the ''examples/&lt;module&gt;/'' directory. Make sure you create a screenshot with a file name that ends in '' -example.png''.<br /> The [[Qt Documentation Structure|Qt_Documentation_Structure]] page contains the documentation structure for examples.
# Add documentation for the example to the ''examples/&amp;lt;module&amp;gt;/'' directory. Make sure you create a screenshot with a file name that ends in ''&amp;nbsp;-example.png''.<br />The [[Qt_Documentation_Structure]] page contains the documentation structure for examples.
# Ensure that the example and documentation files are correctly licensed. Use existing license headers for examples and documentation and update the year accordingly. The headers are in qt5/qtbase
# Ensure that the example and documentation files are correctly licensed. Use existing license headers for examples and documentation and update the year accordingly. The headers are in qt5/qtbase
# Add a link to the example documentation from overviews, the example pages, and other relevant documentation.
# Add a link to the example documentation from overviews, the example pages, and other relevant documentation.
# Add the example to qtdemo by editing the ''demos/qtdemo/xml/examples.xml'' file.
# Add the example to qtdemo by editing the ''demos/qtdemo/xml/examples.xml'' file.
===Categories:===
* [[:Category:Developing-Qt|Developing Qt]]
** [[:Category:Developing-Qt::Documentation|Documentation]]

Revision as of 10:48, 24 February 2015

English Русский Spanish Italian 简体中文

Integrating Qt Examples

Once you have written an example (see Writing Qt Examples) and documented it, you need to do the following things to ensure that it will work correctly within Qt's build and documentation systems:

  1. Ensure that the example's .pro file contains the standard rules for installation.
  2. Add the example directory to the parent directory's .pro file. Make sure that the example compiles when make sub-examples is run.
  3. Add documentation for the example to the examples/&lt;module&gt;/ directory. Make sure you create a screenshot with a file name that ends in &nbsp;-example.png.
    The Qt_Documentation_Structure page contains the documentation structure for examples.
  4. Ensure that the example and documentation files are correctly licensed. Use existing license headers for examples and documentation and update the year accordingly. The headers are in qt5/qtbase
  5. Add a link to the example documentation from overviews, the example pages, and other relevant documentation.
  6. Add the example to qtdemo by editing the demos/qtdemo/xml/examples.xml file.