openorienteering / mapper-manual Goto Github PK

Bad URL:

• https://openorienteering.org/*

Good URL:

• https://www.openorienteering.org/*

Is it possible to fix redirection from https://openorienteering.org/* to https://www.openorienteering.org/*?

As of 0.6.1

Currently the manual is largely tool-based: there are pretty good references to all tools and what these do. However, what I feel is missing is descriptions like "how can I achieve x". For instance, I was unaware there is the duplicate tool and attempted to achieve a similar result with copy-paste. Earlier I have used other inefficient ways to achieve various results.

However, I don't see any obvious place where to add such information. True, there are a number of task-based entries (geo-referencing, tags and others). But what about creating a new section? We have "first steps", perhaps do something like "next steps", that would contain topics like "how to work with vegetation", "how to draw smooth lines", "how to use lidar data" and so on?

Other thoughts?

Have you considered Gitbook as a way to serve your manual? Would look like:

As a user I prefer its interface– it natively has:

• Table of Contents
• Search functionality
• Epub/pdf/etc. auto-builds with each deploy (my dad recently printed the current manual, so there's a need there..)
• More features if you want them? I quite like glossary support, for example.

As far as I can tell, a switch would keep your current features, including an in-browser editor that's pretty well featured (though I don't personally use it so can't fully vouch).

It's free for open source projects, & the project maintainers are responsive on Slack if support is needed. I maintain the Tessel Project (tessel.io) and we switched to Gitbook from a Jekyll-based solution because it was simpler and prettier in the GH view.

Conversion would be pretty simple– right now I'm using a not-really-converted version of your manual via:

git clone
book sm (autogenerate table of contents from file structure)
gitbook serve

which is where I pulled the screen shot from.

Autogen contents sidebar:

I'm currently using Gitbook for a few projects, if you want to poke around examples–

• WIP cartography tutorials: https://frijol.gitbooks.io/orienteering-software-tutorials/content/ (pretty lightweight use)
• Climate change notes for a book: https://frijol.gitbooks.io/climate-change/content/notes/energy/storage.html (much heavier use, hover underlined words if you want to check out the glossary feature)
• Tessel's docs: tessel.io/docs (all of this is auto-deployed when we update content)

Let me know if this is of interest– I can commit a bit of time and don't think it takes much.

As of Mapper 0.6.1

On the View Menu page their is a stray table tag right below the main title.

http://www.openorienteering.org/mapper-manual/pages/view_menu.html

The original html code looks okay, so might be something to do with the publishing process. I couldn't work out how to fix it.

Required for OpenOrienteering/mapper#347

Need fix shortcuts on "View Menu" page:

• https://github.com/OpenOrienteering/mapper-manual/blob/gh-pages/pages/view_menu.md

• Now they look like: (Key), Key

• On all other pages now used style: **Key**

I propose next one as copyright mark:

• (c) The OpenOrienteering developers & contributors

As license propose use some of Creative Commons:

• https://creativecommons.org/licenses/by/4.0/
• https://creativecommons.org/licenses/by-sa/4.0/

Add into manual info about CRT-files and how to use it in OOMapper

REFERENCES:

• https://ocad.com/wiki/ocad12/en/index.php?title=Cross_Reference_Table
• http://www.ocad.com/wiki/ocad11/en/?title=Cross_Reference_Table
• http://www.attackpoint.org/discussionthread.jsp/message_943534

at http://www.openorienteering.org/mapper-manual/pages/templates.html there is raw html code:

<h4>Types of templates</h4>

Use <kbd>Key</kbd> tag for all shortcuts in manual instead?

• Now we has:

  New

  Ctrl+N

• Try:

  New

  Ctrl+N

  or

  New (Ctrl+N)

I use Ghostwriter text editor for Markdown files editing, that support many widely used rendering styles

• https://github.com/wereturtle/ghostwriter/releases/tag/v1.5.0

Here are variants (including current) for organize shortcuts in manual

Just don't know is it supported by all

• Github Flavoured Markdown
• Github Pages
• Doxygen Markdown

Please check text and hyperlinks on this page

• http://www.openorienteering.org/mapper-manual/pages/mapping-introduction.html

It need correction
Also, there are few mistakes in text, like The fieldwork is scanned —

I planned to translate the manual into my native language, but I'm confused a little bit... I don't understand how to make it properly in order to not to break anything in online or offline documentation.
Could you provide instructions for translators like you have provided it for regular contributors?

Luděk Krtička («Orienteering Mappers Int.» Facebook group staff) proposed reborn «O-wiki» (discontinued) wiki site as new «O-Map Wiki» for collecting info & docs about all aspects of orienteering mapping & orienteering software, including section about OpenOrienteering Mapper:

• https://facebook.com/groups/485564718218028?view=permalink&id=1880528808721605

This is something I was talking about at ICOM in Prague: O-Map Wiki project. I would like to hear your opinion and suggestions. Also, I would like to invite you to make comments to the structure and content of the project proposal.

• https://docs.google.com/document/d/1hKtoPnmP7QZpnxPJ6-8WLSm15vUesoxaJuU-Nsi8S-I/

P.S.: I would took part in writing articles for «O-Map Wiki» on some aspects of OpenOrienteering Mapper usage.

REFERENCE

• http://ol-wiki.de
• http://web.archive.org/web/*/http://o-wiki.net
• http://uk.wikipedia.org/wiki/OpenOrienteering_Mapper

Add possibility convert this manual to PDF document.

Introduced in 0.6.1

Add messagebox with information "Open online Help?" if there no Assistant installed or cant open local help.

Im trying to convert a map that started in OCAD to ISOM 2017 symbols. I have tried Symbols->Replace Symbol Set, then selecting the ISOM 2017 symbol set and loading the ISOM2000-ISOM2017.crt. This does not select all the symbols. I have also tried creating a OCD-ISOM2017.crt, and changing the Symbol Set ID, no luck.

Only thing I could get to work was first replacing the symbol set with with an ISOM2000, matched on number, then replacing that.

file attached with ocad
test_crt_ocad.zip
symbol set and a few random symbols

The page pages/gdal.md suggests that all geospatial raster data can be used as templates. However, Mapper throws an error when trying to open data saved as GrayFloat32, which is a common internal format in GeoTIFFs representing data like height, slope etc. It appears that this data must first be saved in the GeoTIFF as RGB values, presumably a triplet of UInt8s (I'm guessing here). This restriction also occurs with other file extensions. This is an undocumented restriction on types of data that Mapper can load.

I have not encountered any restrictions on vector data. In particular, I can directly load the contour export from QGIS into Mapper.

I suggest updating the GDAL page to explain this (it would have saved me hours today). If it is appropriate to include, the instructions for exporting raster scalars from QGIS are: Calculate and make pretty your layer (e.g. of slope). Go to Layer->Save As. Change the Output mode to Rendered image. Input your file name and any other parameters. Click OK.

Mapper version: 0.9.4

I am from China. I want to create a Chinese Manual. What should I do?

Need add some info (as chapter) about "pie menu", that came since OpenOrienteering Mapper v0.4, and how it work/look in different situations.

• http://www.openorienteering.org/news/2012/openorienteering-mapper-0-4-provides-a-wealth-of-new-features
  ...
  Editing tools
• Right-click pie menu for quick tool switching without keyboard shortcuts
  
  The ring-shaped context menu allows for quick access to tools.

REFERENCES

• https://medium.com/@donhopkins/pie-menus-936fed383ff1
  • https://news.ycombinator.com/item?id=17098179

Doesn´t have the english version of OOM but will try to translate my sugestion to the manual:

Use this if you don´t have a text icon in the Symbol Pane or if you want to add more text icons for other text-sizes or collours.

1. Right click under the icons in the ?ymbol Pane (picture).
2. Choose "New Symbol" then "Text" and a new window called "Symbol Preferenses show up.
3. Under the first tab named "Text General", you fill in a number (for example 1) in the becomming icons number box. Fill in a name (for example "Headline".
4. Click on the second tab "Text Preferences" and choose the size. Most important is to choosing a colour and if you forget this you can´t see any text.
5. Click "OK" and a new icon showing the letter "A" is now seen in the Symbol Pane window.
6. Choose the text icon you created and place it on the map and then type the text. A small window will open up in the maps left top corner, showing where the text will be positioned in relation to the marker you placed on the map before typing the text.

Excuse me for my bad english!

Need fix tables in distributed manual.

Here are same pages in online manual, but it hasn't such mistakes

• http://www.openorienteering.org/mapper-manual/pages/file_menu.html
• http://www.openorienteering.org/mapper-manual/pages/edit_menu.html
• http://www.openorienteering.org/mapper-manual/pages/map_menu.html
• http://www.openorienteering.org/mapper-manual/pages/symbols_menu.html
• http://www.openorienteering.org/mapper-manual/pages/templates_menu.html

Currently there are 3 versions of PDF manual:

• OpenOrienteering-Mapper-0.x.x-Manual.pdf - https://download.opensuse.org/repositories/home:/dg0yt/Windows/OpenOrienteering-Mapper-0.8.1-Manual.pdf.zip
• OpenOrienteering-Mapper-master_0.x.YYYYMMDD-Manual - https://download.opensuse.org/repositories/home:/dg0yt/Windows/OpenOrienteering-Mapper-master_0.8.20180805-Manual.pdf.zip
• OpenOrienteering-Mapper-master-qt59_0.x.YYYYMMDD-Manual.pdf - https://download.opensuse.org/repositories/home:/dg0yt/Windows/OpenOrienteering-Mapper-master-qt59_0.8.20180805-Manual.pdf.zip

For what reason you generate OpenOrienteering-Mapper-master-qt59_0.x.YYYYMMDD-Manual.pdf?