Update readmes
This commit is contained in:
parent
891e999216
commit
ebd17a1e10
174
README
174
README
|
|
@ -1,107 +1,77 @@
|
||||||
------------------------------
|
|
||||||
Photo and Image Kooker Application
|
|
||||||
2.99 Development Branch
|
|
||||||
------------------------------
|
|
||||||
|
|
||||||
This is an unstable development release, an intermediate state on the
|
-------------------------------------------------------------------------------
|
||||||
way to the next stable release: PIKA 3.0. PIKA 2.99 may or may not do
|
|
||||||
what you expect. Save your work early and often. If you want a stable
|
|
||||||
version, please use PIKA 2.10 instead.
|
|
||||||
|
|
||||||
If you think you found a bug in this version, please make sure that it
|
Photo and Image Kooker App (Pika)
|
||||||
hasn't been reported earlier and that it is not just new stuff that is
|
|
||||||
still being worked on and obviously not quite finished yet.
|
|
||||||
|
|
||||||
If you want to hack on PIKA, please read the file devel-docs/README.md.
|
a fork of
|
||||||
For detailed installation instructions, see the file INSTALL.
|
|
||||||
|
Gnu Image Manipulation Program
|
||||||
|
|
||||||
|
created with
|
||||||
|
|
||||||
|
Heckimp
|
||||||
|
|
||||||
|
brought to you by Aldercone Studio
|
||||||
|
|
||||||
|
http://aldercone.studio
|
||||||
|
http://heckin.technology
|
||||||
|
|
||||||
|
-------------------------------------------------------------------------------
|
||||||
|
|
||||||
|
This fork was prepared from the GnuImp unstable branch. It works reasonably well, though.
|
||||||
|
Presently python and vala scripts don't seem to be working due to bugs upstream. We'll
|
||||||
|
keep abreast upstream though.
|
||||||
|
|
||||||
|
Build instructions (Linux / Unix-likes):
|
||||||
|
|
||||||
|
You will need gegl and babl, and to build newish version of them. The easiest way to do
|
||||||
|
this is to go to the respective homepages, clone the source and build them as instructed.
|
||||||
|
|
||||||
|
https://www.gegl.org/babl/
|
||||||
|
https://www.gegl.org/
|
||||||
|
|
||||||
|
On some systems libbabl and libgegl might be up to date enough to use the system packages
|
||||||
|
but they are somewhat tightly coupled.
|
||||||
|
|
||||||
|
Once that is installed, Pika can be built from source. You will also need relatively
|
||||||
|
recent GTK3 development libraries and numerous other libraries for file format support and
|
||||||
|
similar.
|
||||||
|
|
||||||
|
Partial package list on Debian/Ubuntu/etc:
|
||||||
|
|
||||||
|
appstream-util bison build-essential cmake desktop-file-utils flex gjs libaa1-dev libappstream-glib-dev libarchive-dev
|
||||||
|
libatk1.0-dev libcairo2-dev libcfitsio-dev libexiv2-dev libfontconfig-dev libfreetype-dev libgdk-pixbuf-2.0-dev
|
||||||
|
libgexiv2-dev libglib2.0-dev libgs-dev libgtk-3-dev libgudev-1.0-dev libharfbuzz-dev libheif-dev libjpeg-dev
|
||||||
|
libjson-glib-dev liblcms2-dev libmng-dev libmypaint-dev libopenexr-dev libopenjp2-7-dev libpango1.0-dev libpng-dev
|
||||||
|
libpoppler-dev libpoppler-glib-dev librsvg2-dev libtiff-dev libunwind-dev libwebp-dev libwmf-dev libx11-dev
|
||||||
|
libxcursor-dev libxext-dev libxfixes-dev libxmu-dev libxpm-dev libzstd-dev luajit meson mypaint-brushes ninja-build
|
||||||
|
pappler-data python3-gi-dev xmllint xsltproc
|
||||||
|
|
||||||
|
Seems like a lot! But many of these are for format support. This is for the maximal setup we've tested.
|
||||||
|
|
||||||
|
Once those are installed, it's time to build!
|
||||||
|
|
||||||
|
First run meson to make the build files:
|
||||||
|
|
||||||
|
meson _build --prefix=/usr/local --buildtype=release -Dpython=enabled -Dvala=disabled -Dgi-docgen=disabled
|
||||||
|
|
||||||
|
This will also tell you if you're missing important bits. We disable vala and gi-docgen because they fail currently,
|
||||||
|
the docgen perhaps is something we can fix but haven't yet.
|
||||||
|
|
||||||
|
Next you build the actual program by doing:
|
||||||
|
|
||||||
|
cd _build
|
||||||
|
ninja
|
||||||
|
|
||||||
|
Then if successful, install with
|
||||||
|
|
||||||
|
sudo ninja install
|
||||||
|
|
||||||
|
And that's it! Pika should show up in your menu if everything worked out.
|
||||||
|
|
||||||
|
If everything didn't work out, let us know, we can probably help! Contact us on fediverse @aldercone@mastodon.art.
|
||||||
|
|
||||||
|
If you want to help, contact us also! We'll be keeping synced with upstream as best as possible and working on
|
||||||
|
containerized builds and builds for other platforms as soon as we can!
|
||||||
|
|
||||||
|
|
||||||
1. Web Resources
|
|
||||||
================
|
|
||||||
|
|
||||||
PIKA's home page is at:
|
|
||||||
|
|
||||||
https://heckin.technology/AlderconeStudio/PIKApp/
|
|
||||||
|
|
||||||
Please be sure to visit this site for information, documentation,
|
|
||||||
tutorials, news, etc. All things PIKA-ish are available from there.
|
|
||||||
|
|
||||||
The latest version of PIKA can be found at:
|
|
||||||
|
|
||||||
https://heckin.technology/AlderconeStudio/PIKApp/downloads/
|
|
||||||
|
|
||||||
|
|
||||||
2. Contributing
|
|
||||||
===============
|
|
||||||
|
|
||||||
PIKA source code can be found at:
|
|
||||||
|
|
||||||
https://gitlab.gnome.org/GNOME/pika/
|
|
||||||
|
|
||||||
Resources for contributors:
|
|
||||||
|
|
||||||
https://developer.pika.org/
|
|
||||||
|
|
||||||
In particular, you may want to look in the "Core Development" section. Some
|
|
||||||
articles of particular interest for newcomers could be:
|
|
||||||
|
|
||||||
* Setting up your developer environment: https://developer.pika.org/core/setup/
|
|
||||||
* PIKA Coding Style: https://developer.pika.org/core/coding_style/
|
|
||||||
* Submit your first patch: https://developer.pika.org/core/submit-patch/
|
|
||||||
|
|
||||||
|
|
||||||
3. Discussion Channels
|
|
||||||
======================
|
|
||||||
|
|
||||||
We have several discussion channels dedicated to PIKA user and
|
|
||||||
development discussion. There is more info at:
|
|
||||||
|
|
||||||
https://heckin.technology/AlderconeStudio/PIKApp/discuss.html
|
|
||||||
|
|
||||||
Links to several archives of the mailing lists are included in that page.
|
|
||||||
|
|
||||||
Pika-user-list is a mailing list dedicated to user problems, hints and
|
|
||||||
tips, discussion of cool effects, etc. Gimp-developer-list is oriented
|
|
||||||
to PIKA core and plug-in developers. Gimp-gui-list is for discussing
|
|
||||||
about PIKA interface to improve user experience. Most people will only
|
|
||||||
want to be subscribed to pika-user-list. If you want to help develop
|
|
||||||
PIKA, the pika-developer mailing list is a good starting point; if you
|
|
||||||
want to help with GUI design, the pika-gui list is where you want to
|
|
||||||
subscribe.
|
|
||||||
|
|
||||||
Other discussion channels can be listed on this page when they are
|
|
||||||
moderated by a team member, such as forums.
|
|
||||||
|
|
||||||
Finally, for the real junkies, there are IRC channels devoted to PIKA.
|
|
||||||
On PIKANet (a private free software oriented network) there is #pika.
|
|
||||||
Many of the developers hang out there. Some of the PIKANet servers are:
|
|
||||||
|
|
||||||
irc.gimp.org:6667
|
|
||||||
irc.us.gimp.org:6667
|
|
||||||
irc.eu.gimp.org:6667
|
|
||||||
|
|
||||||
|
|
||||||
4. Customizing
|
|
||||||
==============
|
|
||||||
|
|
||||||
The look of PIKA's interface can be customized like any other GTK+ app
|
|
||||||
by editing files in `${XDG_CONFIG_HOME}/gtk-3.0/` (settings.ini and
|
|
||||||
gtk.css in particular) or by using "themes" (ready-made customizations).
|
|
||||||
Additionally, PIKA reads `${XDG_CONFIG_HOME}/PIKA/2.99/pika.css` so you
|
|
||||||
can have settings that only apply to PIKA.
|
|
||||||
|
|
||||||
You can also manually change the keybindings to any of your choice by
|
|
||||||
editing: `${XDG_CONFIG_HOME}/PIKA/2.99/shortcutsrc`.
|
|
||||||
|
|
||||||
|
|
||||||
Have fun,
|
|
||||||
|
|
||||||
Spencer Kimball
|
|
||||||
Peter Mattis
|
|
||||||
Federico Mena
|
|
||||||
Manish Singh
|
|
||||||
Sven Neumann
|
|
||||||
Michael Natterer
|
|
||||||
Dave Neary
|
|
||||||
Martin Nordholts
|
|
||||||
Jehan
|
|
||||||
|
|
|
||||||
|
|
@ -0,0 +1,107 @@
|
||||||
|
------------------------------
|
||||||
|
Photo and Image Kooker Application
|
||||||
|
2.99 Development Branch
|
||||||
|
------------------------------
|
||||||
|
|
||||||
|
This is an unstable development release, an intermediate state on the
|
||||||
|
way to the next stable release: PIKA 3.0. PIKA 2.99 may or may not do
|
||||||
|
what you expect. Save your work early and often. If you want a stable
|
||||||
|
version, please use PIKA 2.10 instead.
|
||||||
|
|
||||||
|
If you think you found a bug in this version, please make sure that it
|
||||||
|
hasn't been reported earlier and that it is not just new stuff that is
|
||||||
|
still being worked on and obviously not quite finished yet.
|
||||||
|
|
||||||
|
If you want to hack on PIKA, please read the file devel-docs/README.md.
|
||||||
|
For detailed installation instructions, see the file INSTALL.
|
||||||
|
|
||||||
|
|
||||||
|
1. Web Resources
|
||||||
|
================
|
||||||
|
|
||||||
|
PIKA's home page is at:
|
||||||
|
|
||||||
|
https://heckin.technology/AlderconeStudio/PIKApp/
|
||||||
|
|
||||||
|
Please be sure to visit this site for information, documentation,
|
||||||
|
tutorials, news, etc. All things PIKA-ish are available from there.
|
||||||
|
|
||||||
|
The latest version of PIKA can be found at:
|
||||||
|
|
||||||
|
https://heckin.technology/AlderconeStudio/PIKApp/downloads/
|
||||||
|
|
||||||
|
|
||||||
|
2. Contributing
|
||||||
|
===============
|
||||||
|
|
||||||
|
PIKA source code can be found at:
|
||||||
|
|
||||||
|
https://gitlab.gnome.org/GNOME/pika/
|
||||||
|
|
||||||
|
Resources for contributors:
|
||||||
|
|
||||||
|
https://developer.pika.org/
|
||||||
|
|
||||||
|
In particular, you may want to look in the "Core Development" section. Some
|
||||||
|
articles of particular interest for newcomers could be:
|
||||||
|
|
||||||
|
* Setting up your developer environment: https://developer.pika.org/core/setup/
|
||||||
|
* PIKA Coding Style: https://developer.pika.org/core/coding_style/
|
||||||
|
* Submit your first patch: https://developer.pika.org/core/submit-patch/
|
||||||
|
|
||||||
|
|
||||||
|
3. Discussion Channels
|
||||||
|
======================
|
||||||
|
|
||||||
|
We have several discussion channels dedicated to PIKA user and
|
||||||
|
development discussion. There is more info at:
|
||||||
|
|
||||||
|
https://heckin.technology/AlderconeStudio/PIKApp/discuss.html
|
||||||
|
|
||||||
|
Links to several archives of the mailing lists are included in that page.
|
||||||
|
|
||||||
|
Pika-user-list is a mailing list dedicated to user problems, hints and
|
||||||
|
tips, discussion of cool effects, etc. Gimp-developer-list is oriented
|
||||||
|
to PIKA core and plug-in developers. Gimp-gui-list is for discussing
|
||||||
|
about PIKA interface to improve user experience. Most people will only
|
||||||
|
want to be subscribed to pika-user-list. If you want to help develop
|
||||||
|
PIKA, the pika-developer mailing list is a good starting point; if you
|
||||||
|
want to help with GUI design, the pika-gui list is where you want to
|
||||||
|
subscribe.
|
||||||
|
|
||||||
|
Other discussion channels can be listed on this page when they are
|
||||||
|
moderated by a team member, such as forums.
|
||||||
|
|
||||||
|
Finally, for the real junkies, there are IRC channels devoted to PIKA.
|
||||||
|
On PIKANet (a private free software oriented network) there is #pika.
|
||||||
|
Many of the developers hang out there. Some of the PIKANet servers are:
|
||||||
|
|
||||||
|
irc.gimp.org:6667
|
||||||
|
irc.us.gimp.org:6667
|
||||||
|
irc.eu.gimp.org:6667
|
||||||
|
|
||||||
|
|
||||||
|
4. Customizing
|
||||||
|
==============
|
||||||
|
|
||||||
|
The look of PIKA's interface can be customized like any other GTK+ app
|
||||||
|
by editing files in `${XDG_CONFIG_HOME}/gtk-3.0/` (settings.ini and
|
||||||
|
gtk.css in particular) or by using "themes" (ready-made customizations).
|
||||||
|
Additionally, PIKA reads `${XDG_CONFIG_HOME}/PIKA/2.99/pika.css` so you
|
||||||
|
can have settings that only apply to PIKA.
|
||||||
|
|
||||||
|
You can also manually change the keybindings to any of your choice by
|
||||||
|
editing: `${XDG_CONFIG_HOME}/PIKA/2.99/shortcutsrc`.
|
||||||
|
|
||||||
|
|
||||||
|
Have fun,
|
||||||
|
|
||||||
|
Spencer Kimball
|
||||||
|
Peter Mattis
|
||||||
|
Federico Mena
|
||||||
|
Manish Singh
|
||||||
|
Sven Neumann
|
||||||
|
Michael Natterer
|
||||||
|
Dave Neary
|
||||||
|
Martin Nordholts
|
||||||
|
Jehan
|
||||||
Loading…
Reference in New Issue
