[Qgis-community-team] Doc images and github
Alexandre Neto
senhor.neto at gmail.com
Wed Jan 27 02:28:30 PST 2016
Hi Richard,
Yes proceed please. Working with vector is a nice chapter to test, as it's
very abrangent.
Yves Jacolin <yjacolin at free.fr> escreveu no dia quarta, 27/01/2016 às 09:28:
> Richard,
>
> I am not a big contributor. But I am ok with option 2 as well.
>
> Y.
> On Wednesday, January 27, 2016 10:00:39 Richard Duivenvoorde wrote:
> > Others?
> >
> > Else I think I'll start to do all whole rst files in working_with_vector
> > directory and commit in one go. So it can be reversed if we hit problems.
> >
> > @Alexandre: putting ALL rst file in one dir would indeed help, but I
> > think we need the structure to be able to eventually build partial
> > documentation sets.
> > We could put the substitutions maybe in the index.rst files in the
> > directory where the images dir also is, but that would also scatter the
> > substitutions. Then I think having them in de file where you need them
> > is easiest, also because then you can move around the rst file in the
> > directory structure without fixing relative paths... (as long as you
> > copy the images also to the right place off course :-) ).
> >
> > Anyway: proceed?
> >
> > Richard
> >
> > On 26-01-16 14:08, Otto Dassau wrote:
> > > Hi Richard,
> > >
> > > thanks a lot for this grep/count. In this case I would vote for option
> 2:
> > >
> > > ..."define figures locally in the rst file where you use them. This
> has as
> > > drawback that very often used inline images (like the checkbox) are
> > > defined
> > > + image copied very often. BUT the nice thing about it is that IF you
> > > define them in the rst file, Github is able to resolve those SO they
> show
> > > up as inline images there."
> > >
> > > Regards
> > > Otto
> > >
> > > Am Mon, 25 Jan 2016 21:34:51 +0100
> > >
> > > schrieb Richard Duivenvoorde <richard at duif.net>:
> > >> On 25-01-16 11:06, Alexandre Neto wrote:
> > >>> Not an easy choice... I'm not very fond of duplicating substitutions
> > >>> images as I believe it will lead to pages with different icons
> because
> > >>> someone just update one place. Maybe it would be possible to have a
> > >>> common place with all images and some kind of script to copy the
> icons
> > >>> to a child forder near the rst?
> > >>
> > >> FYI, I did a quick grep/count on all substitutions over ALL docs (so
> not
> > >> only manual).
> > >>
> > >> While I agree with your point... there are not so many images used > 2
> > >> times...
> > >>
> > >> |nix| 45
> > >> |win| 15
> > >> |osx| 9
> > >> |action| 2
> > >> |analysis| 1
> > >> |attributes| 4
> > >> |basic_statistics| 2
> > >> |browsebutton| 10
> > >> |buffer| 2
> > >> |calendarwidget| 0
> > >> |checkbox| 41
> > >> |checkbox_checked| 1
> > >> |checkbox_unchecked| 1
> > >> |check_geometry| 2
> > >> |centroids| 2
> > >> |clip| 2
> > >> |color| 0
> > >> |colormap| 0
> > >> |columnview| 0
> > >> |combobox| 0
> > >> |commandlinkbutton| 0
> > >> |convex_hull| 2
> > >> |coordinate_capture| 2
> > >> |copyright_label| 2
> > >> |CRS| 1
> > >> |create_gpx| 1
> > >> |dateedit| 0
> > >> |datetimeedit| 0
> > >> |dbmanager| 2
> > >> |define_projection| 2
> > >> |delaunay| 2
> > >> |delimited_text| 2
> > >> |dem_analysis| 1
> > >> |diagram| 2
> > >> |dial| 0
> > >> |dialogbuttonbox| 0
> > >> |difference| 2
> > >> |digitising| 0
> > >> |dissolve| 2
> > >> |dockwidget| 0
> > >> |doublespinbox| 0
> > >> |dxf2shp_converter| 3
> > >> |edit| 4
> > >> |eliminate| 1
> > >> |event_browser| 1
> > >> |event_id| 3
> > >> |evis_connect| 2
> > >> |evis_file| 2
> > >> |export_geometry| 2
> > >> |export_projection| 1
> > >> |extract_nodes| 2
> > >> |fontcombobox| 0
> > >> |frame| 0
> > >> |ftools| 2
> > >> |fullCumulativeStretch| 1
> > >> |FullHistogramStretch| 1
> > >> |gdal| 1
> > >> |gdal_about| 0
> > >> |gdal_assign_projection| 1
> > >> |gdal_contour| 1
> > >> |gdal_dem| 1
> > >> |gdal_edit| 0
> > >> |gdal_extract_projection| 1
> > >> |gdal_fillnodata| 1
> > >> |gdal_grid| 1
> > >> |gdal_merge| 1
> > >> |gdal_nearblack| 1
> > >> |gdal_polygonize| 1
> > >> |gdal_proximity| 1
> > >> |gdal_raster-clip| 1
> > >> |gdal_raster-overview| 1
> > >> |gdal_raster-paletted| 0
> > >> |gdal_raster-rgb| 1
> > >> |gdal_rasterize| 1
> > >> |gdal_reset| 0
> > >> |gdal_sieve| 1
> > >> |gdal_tileindex| 1
> > >> |gdal_tooltip| 0
> > >> |gdal_translate| 1
> > >> |gdal_vrt| 1
> > >> |gdal_warp| 1
> > >> |general| 2
> > >> |gentlelogo| 10
> > >> |geographic| 3
> > >> |geometry| 1
> > >> |geometrychecker| 2
> > >> |geometrysnapper| 2
> > >> |geoprocessing| 2
> > >> |georeferencer| 1
> > >> |geRasterometry| 0
> > >> |gps_importer| 2
> > >> |gpstrack_barchart| 2
> > >> |gpstrack_polarchart| 2
> > >> |graphicsview| 0
> > >> |grass| 2
> > >> |grass_close_mapset| 2
> > >> |grass_location| 1
> > >> |grass_new_mapset| 3
> > >> |grass_open_mapset| 2
> > >> |grass_region| 2
> > >> |grass_set_region| 1
> > >> |grass_region_edit| 1
> > >> |grass_tools| 3
> > >> |groupbox| 0
> > >> |groupboxcollapsible| 0
> > >> |heatmap| 4
> > >> |histogram| 0
> > >> |hscrollbar| 0
> > >> |hslider| 0
> > >> |hsplit| 0
> > >> |iconAboutConsole| 0
> > >> |iconClassBrowserConsole| 0
> > >> |iconClassConsole| 0
> > >> |iconClassTreeWidgetConsole| 0
> > >> |iconClearConsole| 0
> > >> |iconCloseTabEditorConsole| 0
> > >> |iconCodepadConsole| 0
> > >> |iconCommentEditorConsole| 0
> > >> |iconCopyEditorConsole| 0
> > >> |iconCutEditorConsole| 0
> > >> |iconFileTabsMenuConsole| 0
> > >> |iconFunctionTreeWidgetConsole| 0
> > >> |iconHelpConsole| 0
> > >> |iconHideToolConsole| 0
> > >> |iconIfaceConsole| 0
> > >> |iconMethodTreeWidgetConsole| 0
> > >> |iconNewTabEditorConsole| 0
> > >> |iconOpenConsole| 0
> > >> |iconPasteEditorConsole| 0
> > >> |iconQtCoreConsole| 0
> > >> |iconQtGuiConsole| 0
> > >> |iconRestoreTabsConsole| 0
> > >> |iconRunConsole| 0
> > >> |iconRunScriptConsole| 0
> > >> |iconSaveAsConsole| 0
> > >> |iconSaveConsole| 0
> > >> |iconScriptConsole| 0
> > >> |iconSettingsConsole| 0
> > >> |icon_newgpx| 1
> > >> |icon_dbmanager| 3
> > >> |icon_zonal_statistics| 1
> > >> |import_gpx| 1
> > >> |inputtext| 2
> > >> |interpolation| 2
> > >> |intersect| 2
> > >> |intersections| 2
> > >> |join| 2
> > >> |join_location| 2
> > >> |labels| 1
> > >> |layer_extent| 2
> > >> |locale| 1
> > >> |locked| 2
> > >> |mAction| 3
> > >> |mActionAdd| 1
> > >> |mActionAddAllToOverview| 2
> > >> |mActionAddArrow| 3
> > >> |mActionAddBasicShape| 3
> > >> |mActionAddDelimitedTextLayer| 0
> > >> |mActionAddGCPPoint| 1
> > >> |mActionAddHtml| 2
> > >> |mActionAddImage| 3
> > >> |mActionAddLayer| 1
> > >> |mActionAddLegend| 5
> > >> |mActionAddMap| 6
> > >> |mActionAddMssqlLayer| 2
> > >> |mActionAddNonDbLayer| 1
> > >> |mActionAddOgrLayer| 4
> > >> |mActionAddOracleLayer| 1
> > >> |mActionAddPart| 4
> > >> |mActionAddPostgisLayer| 2
> > >> |mActionAddRasterLayer| 7
> > >> |mActionAddRing| 4
> > >> |mActionAddSpatiaLiteLayer| 3
> > >> |mActionAddWmsLayer| 3
> > >> |mActionAlignBottom| 2
> > >> |mActionAlignHCenter| 2
> > >> |mActionAlignLeft| 4
> > >> |mActionAlignRight| 2
> > >> |mActionAlignTop| 2
> > >> |mActionAlignVCenter| 2
> > >> |mActionAllEdits| 2
> > >> |mActionAnnotation| 2
> > >> |mActionArrowDown| 1
> > >> |mActionArrowLeft| 0
> > >> |mActionArrowRight| 1
> > >> |mActionArrowUp| 0
> > >> |mActionAtlasFirst| 2
> > >> |mActionAtlasLast| 2
> > >> |mActionAtlasNext| 2
> > >> |mActionAtlasPrev| 2
> > >> |mActionAtlasSettings| 1
> > >> |mActionCancelEdits| 1
> > >> |mActionCalculateField| 6
> > >> |mActionCaptureBoundary| 1
> > >> |mActionCaptureCentroid| 1
> > >> |mActionCaptureLine| 4
> > >> |mActionCapturePoint| 4
> > >> |mActionCapturePolygon| 5
> > >> |mActionChangeLabelProperties| 2
> > >> |mActionCheckQgisVersion| 2
> > >> |mActionCollapseTree| 2
> > >> |mActionComposerManager| 4
> > >> |mActionContextHelp| 1
> > >> |mActionCopySelected| 3
> > >> |mActionCustomProjection| 3
> > >> |mActionDeleteAttribute| 3
> > >> |mActionDeleteGCPPoint| 1
> > >> |mActionDeletePart| 4
> > >> |mActionDeleteRing| 4
> > >> |mActionDeleteSelected| 4
> > >> |mActionDeselectAll| 2
> > >> |mActionDraw| 5
> > >> |mActionDupComposer| 2
> > >> |mActionDuplicateLayer| 1
> > >> |mActionEditCopy| 5
> > >> |mActionEditCut| 4
> > >> |mActionEditPaste| 4
> > >> |mActionExpandNewTree| 2
> > >> |mActionExpandTree| 2
> > >> |mActionExportMapServer| 1
> > >> |mActionFileExit| 2
> > >> |mActionFileNew| 3
> > >> |mActionFileOpen| 6
> > >> |mActionFilePrint| 5
> > >> |mActionFileSave| 6
> > >> |mActionFileSaveAs| 9
> > >> |mActionFillRing| 2
> > >> |mActionFilter| 1
> > >> |mActionFolder| 2
> > >> |mActionFormAnnotation| 2
> > >> |mActionFullHistogramStretch| 1
> > >> |mActionGDALScript| 2
> > >> |mActionGroupItems| 2
> > >> |mActionHelpAbout| 2
> > >> |mActionHelpContents| 2
> > >> |mActionHelpSponsors| 2
> > >> |mActionHideAllLayers| 2
> > >> |mActionmIconExpressionEditorOpen| 1
> > >> |mActionIdentify| 6
> > >> |mActionInOverview| 2
> > >> |mActionInvertSelection| 2
> > >> |mActionLabel| 4
> > >> |mActionLabeling| 4
> > >> |mActionLink| 1
> > >> |mActionLinkGeorefToQGis| 2
> > >> |mActionLinkQGisToGeoref| 2
> > >> |mActionLoadGCPpoints| 1
> > >> |mActionLocalHistogramStretch| 1
> > >> |mActionLowerItems| 2
> > >> |mActionMapTips| 3
> > >> |mActionMeasure| 3
> > >> |mActionMeasureAngle| 2
> > >> |mActionMeasureArea| 2
> > >> |mActionMergeFeatAttributes| 3
> > >> |mActionMergeFeatures| 3
> > >> |mActionMoveFeature| 4
> > >> |mActionMoveGCPPoint| 1
> > >> |mActionMoveItemContent| 4
> > >> |mActionMoveItemsToBottom| 2
> > >> |mActionMoveItemsToTop| 2
> > >> |mActionMoveLabel| 2
> > >> |mActionNewAttribute| 3
> > >> |mActionNewBookmark| 2
> > >> |mActionNewComposer| 6
> > >> |mActionNewSpatiaLiteLayer| 2
> > >> |mActionNewVectorLayer| 3
> > >> |mActionNodeTool| 4
> > >> |mActionOffsetCurve| 4
> > >> |mActionOpenRaster| 0
> > >> |mActionOpenTable| 7
> > >> |mActionOptions| 9
> > >> |mActionPan| 6
> > >> |mActionPinLabels| 1
> > >> |mActionProjectProperties| 3
> > >> |mActionPropertyItem| 2
> > >> |mActionQgisHomePage| 2
> > >> |mActionRaiseItems| 3
> > >> |mActionRedo| 5
> > >> |mActionRemove| 1
> > >> |mActionRemoveAllFromOverview| 1
> > >> |mActionRemoveLayer| 3
> > >> |mActionReshape| 4
> > >> |mActionRollbackEdits| 1
> > >> |mActionRotateFeature| 1
> > >> |mActionRotateLabel| 1
> > >> |mActionRotatePointSymbols| 3
> > >> |mActionSaveAsPDF| 4
> > >> |mActionSaveAsSVG| 5
> > >> |mActionSaveEdits| 3
> > >> |mActionSaveGCPpointsAs| 1
> > >> |mActionSaveMapAsImage| 6
> > >> |mActionScaleBar| 4
> > >> |mActionSelect| 10
> > >> |mActionSelectFreehand| 2
> > >> |mActionSelectPan| 1
> > >> |mActionSelectPolygon| 2
> > >> |mActionSelectRadius| 2
> > >> |mActionSelectRectangle| 2
> > >> |mActionSelectedToTop| 2
> > >> |mActionShowAllLayers| 3
> > >> |mActionShowBookmarks| 2
> > >> |mActionShowHideLabels| 1
> > >> |mActionShowPinnedLabels| 1
> > >> |mActionShowPluginManager| 6
> > >> |mActionShowPresets| 3
> > >> |mActionSignMinus| 3
> > >> |mActionSignPlus| 6
> > >> |mActionSimplify| 4
> > >> |mActionSplitFeatures| 5
> > >> |mActionSplitParts| 3
> > >> |mActionStartGeoref| 2
> > >> |mActionTextAnnotation| 2
> > >> |mActionToggleEditing| 6
> > >> |mActionTouch| 1
> > >> |mActionTransformSettings| 2
> > >> |mActionUndo| 5
> > >> |mActionUnGroupItems| 1
> > >> |mActionUnlink| 1
> > >> |mActionUnselectAttributes| 1
> > >> |mActionWhatsThis| 2
> > >> |mActionZoomActual| 3
> > >> |mActionZoomFullExtent| 5
> > >> |mActionZoomIn| 8
> > >> |mActionZoomLast| 3
> > >> |mActionZoomNext| 3
> > >> |mActionZoomOut| 8
> > >> |mActionZoomToLayer| 4
> > >> |mActionZoomToSelected| 4
> > >> |management| 1
> > >> |mapserver_export| 1
> > >> |matrix| 2
> > >> |mean| 2
> > >> |merge_shapes| 2
> > >> |metadata| 2
> > >> |metasearch| 2
> > >> |mGeorefRun| 1
> > >> |mIconAtlas| 3
> > >> |mIconColorBox| 2
> > >> |mIconColorPicker| 2
> > >> |mIconColorSwatches| 2
> > >> |mIconColorWheel| 2
> > >> |mIconDataDefine| 6
> > >> |mIconExpression| 1
> > >> |mIconExpressionSelect| 4
> > >> |mIconImport| 1
> > >> |mIconLock| 2
> > >> |mIconNew| 2
> > >> |mIconProjectionDisabled| 2
> > >> |mIconProjectionEnabled| 3
> > >> |mIconRasterGroup| 1
> > >> |mIconRasterLink| 1
> > >> |mIconStopRendering| 1
> > >> |mIconZip| 1
> > >> |multi_to_single| 2
> > >> |neighbor| 2
> > >> |north_arrow| 2
> > >> |offline_editing_copy| 3
> > >> |offline_editing_sync| 2
> > >> |oracle_raster| 3
> > >> |osm_addRelation| 1
> > >> |osm_createLine| 1
> > >> |osm_createPoint| 1
> > >> |osm_createPolygon| 1
> > >> |osm_createRelation| 1
> > >> |osm_download| 1
> > >> |osm_editRelation| 1
> > >> |osm_featureManager| 1
> > >> |osm_generateTags| 1
> > >> |osm_identify| 1
> > >> |osm_import| 1
> > >> |osm_load| 1
> > >> |osm_move| 1
> > >> |osm_questionMark| 1
> > >> |osm_removeFeat| 1
> > >> |osm_removeTag| 0
> > >> |osm_save| 1
> > >> |osm_upload| 0
> > >> |PanToSelected| 3
> > >> |pencil| 2
> > >> |plugin| 3
> > >> |plugin_installed| 1
> > >> |plugin_installer| 2
> > >> |plugin_upgrade| 1
> > >> |proc_commander| 1
> > >> |proc_history| 1
> > >> |proc_model| 1
> > >> |proc_option| 1
> > >> |proc_result| 1
> > >> |proc_toolbox| 1
> > >> |qgissplash| 0
> > >> |radiobuttonon| 15
> > >> |radiobuttonoff| 10
> > >> |random_points| 2
> > >> |random_selection| 2
> > >> |raster-info| 3
> > >> |raster-interpolate| 2
> > >> |raster-stats| 2
> > >> |raster_terrain| 2
> > >> |regular_points| 2
> > >> |RemoveAllOVerview| 2
> > >> |roadgraph| 1
> > >> |sampling| 1
> > >> |scale_bar| 2
> > >> |selectcolor| 3
> > >> |selectcreatelayer| 2
> > >> |selectnumber| 9
> > >> |selectstring| 17
> > >> |selectesubsetlayer| 2
> > >> |select_location| 2
> > >> |ShowRasterCalculator| 1
> > >> |single_to_multi| 2
> > >> |slider| 6
> > >> |spatialquery| 3
> > >> |spiticon| 2
> > >> |split_layer| 2
> > >> |sub_selection| 2
> > >> |sum_lines| 2
> > >> |sum_points| 2
> > >> |sym_difference| 2
> > >> |symbology| 1
> > >> |simplify| 2
> > >> |tab| 1
> > >> |to_lines| 2
> > >> |topologychecker| 2
> > >> |tracking| 2
> > >> |transformed| 1
> > >> |union| 2
> > >> |unique| 2
> > >> |unlocked| 2
> > >> |user| 1
> > >> |vector_grid| 2
> > >> |wcs| 1
> > >> |wfs| 4
> > >>
> > >> _______________________________________________
> > >> Qgis-community-team mailing list for organizing community resources
> such
> > >> as documentation, translation etc..
> Qgis-community-team at lists.osgeo.org
> > >> http://lists.osgeo.org/mailman/listinfo/qgis-community-team
> >
> > _______________________________________________
> > Qgis-community-team mailing list for organizing community resources such
> as
> > documentation, translation etc.. Qgis-community-team at lists.osgeo.org
> > http://lists.osgeo.org/mailman/listinfo/qgis-community-team
>
> _______________________________________________
> Qgis-community-team mailing list for organizing community resources such
> as documentation, translation etc..
> Qgis-community-team at lists.osgeo.org
> http://lists.osgeo.org/mailman/listinfo/qgis-community-team
--
Alexandre Neto
---------------------
@AlexNetoGeo
http://sigsemgrilhetaswordpress.com
http://gisunchained.wordpress.com
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osgeo.org/pipermail/qgis-community-team/attachments/20160127/ca7edf4f/attachment-0001.html>
More information about the Qgis-community-team
mailing list