Piperpal User Manual

Piperpal Location Intelligence, www.piperpal.com

Draft note: Piperpal's page is a JavaScript app with almost no readable documentation, so this manual is built from the interface labels visible on the site. Items marked (verify) are inferred from a label and should be checked against the live app before you publish this manual.

1. What Piperpal is

Piperpal is a browser-based editor for writing short web content that is linked to real places. You write text, mark place names in it, and Piperpal shows the matching locations on an OpenStreetMap-based map, with nearby photos from Wikimedia Commons. When you are done, you publish the result as an HTML page that you can copy or download.

Piperpal also offers location-based advertising ("Piperpal Location Intelligence Ads"), which can be bought through a link on the page.

2. Getting started

  1. Open www.piperpal.com in any modern browser. No installation is shown or needed.
  2. Start typing in the editor area. The Words and Characters counters update as you write.
  3. Your work is saved automatically in this browser only. The status line reads Not saved yet until the first save, and then shows the size of your document in KB in WebStorage.

Important: Because storage is local to the browser, clearing browsing data, switching browsers or switching devices will lose your draft. Use Download .html regularly to keep a copy.

3. The screen at a glance

Area

What it does

Editor

Where you write and format your text

Counters

Live word and character totals

Toolbar

Formatting and place-marking buttons (section 4)

Places panel

Lists the places found in your text, with sorting (section 5)

Images panel

Photos near the selected place (section 6)

Selected element

Shows the markup of the place you selected (section 7)

Evaluate / Publish

Check and export your document (sections 8 and 9)

4. Toolbar

The toolbar contains these controls. Descriptions come from the button labels.

5. Working with places

Places in your text appear underlined.

  1. Click an underlined place to select it. Until you do, the panels show No place selected.
  2. The selected place is highlighted on the map, and its photos and markup appear.
  3. Use Sort to order the place list by:
    • Distance: nearest first
    • Paid: places with paid placement first
    • Name: alphabetical
  4. Press Refresh to rebuild the list after you edit your text.

6. Photos

The Images panel shows photos from Wikimedia Commons taken near the selected place. These are community-contributed images, and each has its own licence. Check the licence and credit requirements on Wikimedia Commons before reusing a photo in your published page.

7. Selected element

When a place is selected, the Selected element panel shows its HTML markup. If nothing is selected it reads Select a place to see its markup. This is useful for checking exactly what Piperpal will write into your published page.

8. Evaluate

Press Evaluate to check your document. The panel shows Press Evaluate to check the document until you run it. Run it before publishing and fix anything it reports (verify what is checked: likely place links, markup and length).

9. Publish and export

  1. Press Publish.
  2. A Published HTML window opens with your finished page.
  3. Choose Copy HTML to paste the code into your own site or CMS, or Download .html to save a file.
  4. Choose Close to return to the editor.

10. Advertising

Piperpal Location Intelligence Ads can be purchased through the banner or the Piperpal ads button, which leads to a Stripe checkout page. Paid placements are what the Paid sort option refers to (verify). Review pricing and terms on the checkout page before paying.

11. Map data and privacy

12. Tips

13. Troubleshooting

Problem

Try this

Draft is gone

Check you are in the same browser and profile; browser storage may have been cleared

No places underlined

Press Refresh, and check spelling of place names

No photos shown

Select a place first; some places have no nearby Commons photos

Nothing happens on Publish

Run Evaluate and fix any reported issue first

14. Support

No support contact is shown on the page. Contact the operator through www.aamot.io.