InkStitch - installation - Revision history

Daniel K. Schneider at 12:54, 13 November 2024

2024-11-13T12:54:23Z

@@ Line 20: / Line 20: @@
 === Inkscape installation ===
-Install [[Inkscape]] if it is not already installed on your computer. This software runs on Windows (all versions), MacOS, and Linux. We also recommend using the latest stable InkScape version, e.g. in October 2020 it was 1.0.1. So, before installing Ink/Stitch, '''de-install''' your old Inkscape, then '''reinstall''' Inkscape first. However, the latest 0.9 version also works fine, i.e. version 1.x of InkScape is ''not'' required as of fall 2020.
+Install [[Inkscape]] if it is not already installed on your computer. This software runs on Windows (all versions), MacOS, and Linux. We also recommend using the latest stable InkScape version. So, before installing Ink/Stitch, upgrade InkScape.
 '''Download link (Windows, Mac, some Linux)'''
@@ Line 33: / Line 33: @@
 * Within Inkscape, use <code>Edit->Preferences->Interface</code> to set icon sizes. I use "large"
 * Also, in the same settings, adjust the zoom correction factor to make the display wysiwyg. I use 147. If you look at a drawing with 1:1 zoom, the dimensions in mm should be correct if you measure it with a ruler.
 ==== Ubuntu ====
@@ Line 51: / Line 43: @@
 ==== Mac ====
-Installation on a Mac is more difficult .... (this section needs '''updating''')
+Make sure to pick the right version !
-You may have to delete the old extension files first. The download page will tell you so if needed. Go to the extension directory and kill each embroidery* and inkstitch* file. Then, proceed as above. But normally, we repeat, you will not have to do that. Just unzip the archive to extension folder again.
+Read this https://inkstitch.org/docs/install/#macos
 === Language files ===
@@ Line 144: / Line 73: @@
 === Shortcuts ===
-The [https://inkstitch.org/tutorials/resources/beginner-video-tutorials/03-customize-transcript#shortcut-keys official InkStitch documentaiton] recommends defining shortcuts as follows:
+The [https://inkstitch.org/tutorials/resources/beginner-video-tutorials/03-customize-transcript#shortcut-keys official InkStitch documentation] recommends defining shortcuts as follows:
 Open Edit > Preferences. Then select Interface -> Keyboard Shortcuts

Daniel K. Schneider: Text replacement - "$" to " {{edutechwiki}}"

2021-04-10T00:18:38Z

Text replacement - "$" to " {{edutechwiki}}"

← Older revision		Revision as of 02:18, 10 April 2021
Line 175:		Line 175:

	I will try to have this included in future mediawiki versions - [[User:Daniel K. Schneider\|Daniel K. Schneider]] ([[User talk:Daniel K. Schneider\|talk]]) 11:22, 14 June 2018 (CEST)		I will try to have this included in future mediawiki versions - [[User:Daniel K. Schneider\|Daniel K. Schneider]] ([[User talk:Daniel K. Schneider\|talk]]) 11:22, 14 June 2018 (CEST)
			{{edutechwiki}}

Daniel K. Schneider: 1 revision imported

2021-04-09T22:54:00Z

1 revision imported

← Older revision	Revision as of 00:54, 10 April 2021
(No difference)

Daniel K. Schneider: /* Show path outlines and directions */

2020-10-08T13:08:20Z

Show path outlines and directions

New page

{{syllabus
|is_part_of_syllabus=Machine embroidery
|is_part_of_module=InkStitch
|do_not_show_sub_page=No
|page_previous=InkStitch
|page_next=InkStitch - basic use
|status=to improve
|last_modification=2018/06/05
|objective=Understand the purpose of InkStitch, Install InkStitch,
Run a InkStitch annotated SVG file
|difficulty=beginner
|see_also=InkStitch - basic use
|cat_syllabus=InkStitch
|prequisite=InkScape
}}
== Installation ==

This extension software was first tested with Ubuntu 16x and Windows 10 on May 3 2018. We managed to produce embroidery files for both Linux and Windows. Since Ink/Stitch is an extension of the [[Inkscape]] drawing program, you will have to install a recent version of Inkscape. See the next item.

=== Inkscape installation ===

Install [[Inkscape]] if it is not already installed on your computer. This software runs on Windows (all versions), MacOS, and Linux. We also recommend using the latest stable InkScape version, e.g. in October 2020 it was 1.0.1. So, before installing Ink/Stitch, '''de-install''' your old Inkscape, then '''reinstall''' Inkscape first. However, the latest 0.9 version also works fine, i.e. version 1.x of InkScape is ''not'' required as of fall 2020.

'''Download link (Windows, Mac, some Linux)'''

* https://inkscape.org/en/ (home page of Inkscape, follow the download links)

==== Windows ====

Take the desktop version, not the app store version, i.e. 64-bit-architecture

If you got a high resolution screen, then use the two following strategies:
* Within Inkscape, use <code>Edit->Preferences->Interface</code> to set icon sizes. I use "large"
* Also, in the same settings, adjust the zoom correction factor to make the display wysiwyg. I use 147. If you look at a drawing with 1:1 zoom, the dimensions in mm should be correct if you measure it with a ruler.

For older Inkscape versions and for smaller screens (13 to 77'' as opposed to 32''), you may have to fix InkScape Properties through Windows
* Right-click on the InkScape shortcut on your desktop, and select <code>Properties</code>
* Select Compatibility TAB and click on <code>Change high DPI settings</code>. Then, play with the settings. I use the following ones for my little DELL XPS 15 that has a 4K screen.

[[file:Inkscape-high-DPI-setting.png|thumb|600px|none|Fixing DPI resolution of the GUI on Windows 4K laptops]]

This can help with other programs too.

==== Ubuntu ====

Ubuntu users may have to use Inkscape's official Personal Package Archive (PPA). E.g., by default, Ubuntu 16.04LTS distributes an old 0.91 version that lacks the object browser. So, open a terminal and add the repository, then upgrade
sudo add-apt-repository ppa:inkscape.dev/stable
sudo apt-get update
sudo apt upgrade

==== Mac ====

Installation on a Mac is more difficult .... (this section needs '''updating''')

For example, read the [https://inkscape.org/release/inkscape-0.92.2/mac-os-x/107/dmg/dl/ instructions] for the 0.92 download that works with older mac version. Installation requires prior installation of the Unix/Linux graphics layer X that Mac no longer supports by default.....

Catalina only works with Inkscape 1.0 (and the other way round) and Inkstitch 1.28 (may 2020) or better, but Apple added a feature that prohibits installation of software from people that do not pay developer fees. Workaround is to get the files via curl. That situation may change in the future (as of July 2020).

There are two basic steps

(1) Open a terminal. You can google for that, e.g. https://support.apple.com/guide/terminal/open-or-quit-terminal-apd5265185d-f365-44cb-8b09-71a064a42125/mac

(2) Read this https://inkstitch.org/docs/install/#macos

Copy line by line the commands in the black box of the above explanation (without the $, of just take the 3 lines from below) and hit the Enter button each time. Details:

Will put you into the extensions directory of inkscape:
cd ~/.config/inkscape/extensions
Will retrieve InkStitch so that Apple won't complain (note: this is for the current version and you may have to change the filename in the future):
curl -LJO https://github.com/inkstitch/inkstitch/releases/latest/download/inkstitch-refs-tags-v1.28.0-osx-en_US.zip
This will unzip the file (same procedure as in a normal install)
unzip inkstitch-refs-tags-v1.28.0-osx-en_US.zip

Else, ask anyone who knows how to talk to any computer via a terminal for help. The principle is same for Linux, windows, etc.

=== First time Ink/Stitch base installation ===

Ink/Stitch is the embroidery platform that you must install as Inkscape extension.

'''Download the Ink/Stitch extension files'''

* Download the [https://github.com/lexelby/inkstitch/releases/latest latest release]
* De-archive in the personal extension folder of Inkscape. Make sure that the files extract into the extensions folder, e.g. you should see some *.inx files, inkstitch.py, plus an inkstitch directory.

'''Installation under Ubuntu'''

* Extract files to <code> ~/.config/inkscape/extensions</code>
cd ~/.config/inkscape/extensions
tar zxf ~/Downloads/inkstitch-v1.0.0-Linux-x86_64.tar.gz

Development version may use *.zip format. so:
cd ~/.config/inkscape/extensions
unzip ~/distro.zip

'''Installation under Win 10'''
* Unhide the AppData directory (go to c:\users\__your_home__\, e.g. c:\users\janet
* Unzip in <code>c:\users\__you__\AppData\Roaming\inkscape\extensions</code>, e.g. <code>c:\users\janet\AppData\Roaming\inkscape\extensions</code>

If this does not work, check where the extension folder is in <code>Inkscape: Edit->Preferences->System</code>. You also can change the directory, e.g. if you have trouble making the AppData directory visible or if Windows Defender makes your life difficult.

Once you installed the extension, restart Inkscape.

If you use a very high level of Windows Defender protection, you may run into trouble and you may have to white list the extension directory.
* Go to Start > Settings > Updates & Security > Windows Security > Virus & threat protection > Virus & threat protection settings > Add or remove exclusions.

Alternatively, lower the protection threshold (and then avoid downloading random bullshit). In the windows Defender Security Center:
* Set App&Browser control -> Check apps and files to "Warn"
* Set Virus&threat protection -> Virus & threat protection settings -> Controlled Folder access to "Off"

=== Ink/Stitch add-ons installation (do not forget!) ===
There are some add-ons, e.g. installing trim/stop commands, color palettes and visualization of embroidery commands that require copying files. Read more in the [https://inkstitch.org/docs/addons/ official manual].
* Go to <code>Extensions > Ink/Stitch > Install add-ons for Inkscape</code>
* Click <code>Install</code>
* Restart Inkscape

=== Upgrades ===

You may have to delete the old extension files first. The download page will tell you so if needed. Go to the extension directory and kill each embroidery* and inkstitch* file. Then, proceed as above. But normally, we repeat, you will not have to do that. Just unzip the archive to extension folder again.

=== Language files ===

For people with system administration skills (only): Let us assume that you contribute to the translation effort at . You can test the translation file by replacing the "*.mo" file in your language directory.

* Get a po file from a recent developer version, e.g. the [https://github.com/inkstitch/inkstitch/tree/master/translations master branch]
* create a *.mo from a *.po file, under Linux do something like.
msgfmt -o inkstitch.mo messages_fr_FR.po
* Backup file inkscape/extensions/inkstitch/bin/locales/fr_FR directory/inkstitch.mo to inkstitch.mo.old
* Copy the file to the inkscape/extensions/inkstitch/bin/locales/fr_FR directory

== Configuration ==

=== Language ===

Language of downloaded Inkstitch files should match language of Inscape and language of OS.

Your can set the language in Inkscape: <code>Edit -> Preferences -> Interface </code>-

=== Show path outlines and directions ===

In order to create satin columns it is crucial to be able to see the direction of path lines.

To see directions, set <code>Show path direction on outline</code> in Edit -> Preferences -> Tools -> Node

=== Shortcuts ===

The [https://inkstitch.org/tutorials/resources/beginner-video-tutorials/03-customize-transcript#shortcut-keys official InkStitch documentaiton] recommends defining shortcuts as follows:

Open Edit > Preferences. Then select Interface -> Keyboard Shortcuts

# Search for “params”. You will find it under Extensions. To its right, click into the field below the Shortcut column and enter Control + Shift + C.
# Search for “simulate” and enter Control + Shift + L
# Search “Reverse” (under Selection) and enter Control + R
# And finally Page down for “stack down” and Page up for “stack up”. The object at the bottom of the objects list (Object -> Objects) will stitch first.

The [[InkStitch - installation/XML-shortcuts|XML shortcuts]] sub page contains an extended list of shortcuts made by Laure Doisneau plus her explanations

=== Units and grids ===

We suggest always working in mm (if you are familiar with metric units)

== Mediawiki compatibility of SVG files ==

For now, some InkStitch files (e.g. the ones that include previewing information) cannot be imported into a Mediawiki because Mediawikis only allow whitelisted namespace. I filed a [https://phabricator.wikimedia.org/T197595 request] at the wikimedia phabricator but don't know if it may interest a developer.

There are two workarounds:

'''(1) Fix the SVG file'''
* Remove the namespace elements with a text editor from the SVG, i.e. the declaration in the beginning and the section at the end of the metadata

'''(2) Modify the mediawiki code'''
* In file <code>./includes/upload/UploadBase.php</code> around line 1360, add the namespace, eg.
'http://creativecommons.org/ns#',
'http://inkstitch.org/namespace',
'http://inkscape.sourceforge.net/dtd/sodipodi-0.dtd',

I will try to have this included in future mediawiki versions - [[User:Daniel K. Schneider|Daniel K. Schneider]] ([[User talk:Daniel K. Schneider|talk]]) 11:22, 14 June 2018 (CEST)