build-all.sh: “Permission denied” | Start with bash build-all.sh or run chmod +x build-all.sh once |
go is not found under Windows | After installing Go open a new terminal. If that does not help, restart the computer |
go mod tidy fails | Check the internet connection and proxy settings |
| Port in use | Choose another port: go run . -addr 127.0.0.1:9000 |
| The browser does not open | Open the address from the terminal output by hand |
| “Barcode invalid” / “QR code invalid” in the field | The content contains characters that the chosen format cannot encode (with Code 128 e.g. umlauts) – switch to QR code or avoid umlauts in the content |
| Scanner shows Chinese or Japanese characters instead of umlauts | Code created with an older version: print again. Since 2.1.0 QR codes carry the “UTF-8” information. With DataMatrix/PDF417 the scanner must be set to ISO-8859-1 (Latin-1), which is the default there |
| Umlauts in the CSV are broken | Save the file as UTF-8 or export from Excel as “CSV UTF-8” |
| Message “Please choose at least one side” | Set a tick at “Print front” or “Print back” |
| With a card printer there is a white edge or the card is too large | Switch off the tick “Print with bleed”, it is only meant for cutting yourself |
| Field stays empty in the PDF | Check whether the placeholder matches exactly a column name of the card data |
| Numbers from the .ods look different than expected (e.g. postcode without leading 0) | The displayed cell content is taken over. Format the column as text in LibreOffice or choose a number format with leading zeros |
| Image field stays empty with “From photos” | The file name of the photo (without extension) must match exactly the value of the chosen CSV column, e.g. 1000123456.jpg to 1000123456. Is the photo uploaded in the “Photos” area? |
| Message “The running program is outdated” after adding an image field | Program and user interface (web/index.html) belong together (see the entry further below) – replace the whole project folder and restart the program |
| Font is not loaded | only .ttf, .otf, .ttc and .otc are read; the message names the reason |
| Front and back are printed although only one is ticked, or the message “The running program is outdated” appears | Program and user interface (web/index.html) belong together. Replace the whole project folder with the newest version, quit the program with Ctrl+C, restart it with go run . and reload the page with Ctrl+F5. The user interface is inside the program file at start, so old programs keep delivering the old version. In the terminal every PDF request shows a line such as PDF-Anfrage: 3 Karten, Vorderseite=false, Rückseite=true |
| The message “Turn the card over” does not appear | It only appears if both ticks “Print front” and “Print back” are set and “Printer prints on both sides (duplex)” is off |
| The message “Turn the card over” appears although the printer prints on both sides | Switch on “Printer prints on both sides (duplex)” in the Print window |
| The print dialog does not appear | Check the browser’s pop-up and print blockers, as a substitute create the PDF and print it by hand |
| PDF error with a card number | The message names the card and page; check the CSV row there |