KPhotoAlbum/uk: Difference between revisions

    From KDE UserBase Wiki
    No edit summary
    No edit summary
    (24 intermediate revisions by 2 users not shown)
    Line 4: Line 4:
    |[[Image:Kphotoalbum_splash.png]] || '''KPhotoAlbum — програма призначена для полегшення впорядкування зображень. У ній передбачено багато можливостей спрощення впорядкування та перегляду зображень'''.<br />  
    |[[Image:Kphotoalbum_splash.png]] || '''KPhotoAlbum — програма призначена для полегшення впорядкування зображень. У ній передбачено багато можливостей спрощення впорядкування та перегляду зображень'''.<br />  
    |}
    |}
    Перші версії '''KPhotoAlbum''' було випущено під назвою "KimDaBa". Поточною версією '''KPhotoAlbum''' є версія 4.7.2 (грудень 2016 року), тестова версія має номер 5.0.1.
    Перші версії '''KPhotoAlbum''' було випущено під назвою "KimDaBa". Стабільні випуски завжди можна знайти на нашій [https://www.kphotoalbum.org/news/ сторінці новин].


    __TOC__
    __TOC__
    Line 21: Line 21:
    === KPhotoAlbum у портативних системах ===
    === KPhotoAlbum у портативних системах ===


    KPhotoAlbum is available in [https://neon.kde.org/download Neon]:
    KPhotoAlbum є частиною [https://neon.kde.org/download Neon]:
    * User Edition has the latest release
    * У редакції для користувачів (User Edition) міститься пакунок найсвіжішого випуску програми
    * Developer Edition (stable branch) has the ''5.x'' branch.<br/>Most of the time, this should be the same as unstable, but when new features are developed they only arrive in stable after the roughest edges have been smoothed out.
    * У стабільній гілці редакції для розробників (Developer Edition) міститься пакунок версії ''5.x''.<br />Найімовірніше, пакунок таий самий, як і пакунок нестабільної версії, але іноді, під час реалізації нових можливостей, можливості з’являються у стабільній версії лише після усування найпомітніших вад.
    * Developer Edition (unstable branch) has the ''master'' branch of kphotoalbum.
    * У нестабільній версії редакції для розробників (Developer Edition) міститься пакунок на основі гілки ''master'' коду kphotoalbum.


    ===Збирання KPhotoAlbum===
    ===Збирання KPhotoAlbum===
    Line 57: Line 57:
    === Дії з приготування випуску KPA===
    === Дії з приготування випуску KPA===


    * Update CMakeLists.txt with the new version number you are just about to tag (alas, our automatic versionning doesn't work anymore ;-)
    * Оновіть CMakeLists.txt, вказавши номер нової версії, гілку для яко щойно було створено (зараз автоматичне визначення версій не працює {{Smiley}})
    * Update the ChangeLog to mark the new release and add the key improvements to the list of changes, if they are not already mentioned in the ChangeLog
     
    * Update doc/index.docbook to reflect the new release (if the documentation has been updated)<br/>{{Input|1=<nowiki><releaseinfo>4.5</releaseinfo></nowiki>}}
    * Оновіть ChangeLog, додавши дані щодо нового випуску і додайти опис ключових змін до списку змін, якщо про ці зміни ще не згадано у ChangeLog
    * Commit the last changes<br/>{{Input|1=<nowiki>git commit -v -a</nowiki>}}
     
    * Tag the new release and push it out<br/>{{Input|1=<nowiki>git tag -a -m "kpa 4.5 released" v4.5
    * Оновіть doc/index.docbook, змінивши у ньому розділи, пов’язані із новим випуском (якщо документацію було оновлено)<br />{{Input|1=<nowiki><releaseinfo>4.5</releaseinfo></nowiki>}}
     
    * Запишіть до локальної копії останні зміни<br />{{Input|1=<nowiki>git commit -v -a</nowiki>}}
     
    * Позначте новий випуск і надішліть зміни до сховища<br />{{Input|1=<nowiki>git tag -a -m "kpa 4.5 released" v4.5
    git push
    git push
    git push --tags</nowiki>}}
    git push --tags</nowiki>}}
    * Create a tar ball of the released sources using the instructions on the following section (''kphotoalbum.rb --version 4.5'')
     
    * Upload the created tar ball to the <tt>incoming</tt> directory of upload.kde.org using an FTP client. The current instructions of notifying administrators of the upload are shown when logging in to the FTP server. You create a ticket and provide SHA sums and some other information of the upload.
    * Створіть архів із кодом, скориставшись настановами із наступного розділу (''kphotoalbum.rb --version 4.5'')
    * Add a new version to Bugzilla (bugs.kde.org, you have to have administrator rights to do this): ''Edit Products → KPhotoAlbum → Add version''
     
    * Update the KPA web pages to point to proper source file, you get a link to the mirroring system as when the uploaded tar to KDE FTP server has been processed. The sources of the web page can be checked out from <tt>svn+ssh://[email protected]/home/kde/trunk/www/sites/kphotoalbum</tt> via svn.
    * Вивантажте створений архів до каталогу <tt>incoming</tt> на upload.kde.org за допомогою клієнтської програми FTP. Поточні настанови щодо інформування адміністраторів щодо вивантаження буде показано під час входу на сервер FTP. Вам слід створити квиток і вказати суми SHA на інші дані щодо вивантаженого.
    * Publish the release information (KPA's web site, mailing lists, distributor's bugtracking system, social media etc.).
     
    ** Don't forget to post on the kde-distro-packagers mailing list, and make sure to mention any changes in dependencies.
    * Додайте нову версію у системі керування вадами (bugs.kde.org, для цього вам знадобляться права адміністратора): ''Edit Products → KPhotoAlbum → Add version''
    ** Update the latest version on top of this page.
     
    * Create a video of the cool new features and publish it on Youtube. A nice tool for doing so is [http://recordmydesktop.sourceforge.net/ recordmydesktop]. If you uploaded such a video, don't forget to add it to the Videos page on the homepage (cf. the <tt>README_new_video.txt</tt> file).
    * Оновіть вебсторінки KPA так, щоб вони вказували на відповідний файл кодів. Посилання на систему дзеркал ви отримаєте під час вивантаження архіву на сервер FTP KDE. Отримати вебсторінку пакунків з кодом можна за допомогою svn за адресою <tt>svn+ssh://[email protected]/home/kde/trunk/www/sites/kphotoalbum</tt>.
    * Notify people building the binary packages for different distributions
     
    * Оприлюдніть інформацію про випуск (сайт KPA, списки листування, системи стеження за вадами дистрибутивів, соціальні мережі тощо).
    ** Не забудьте написати до списку листування kde-distro-packagers, згадавши у листі про будь-які зміни у залежностях.
    ** Оновіть дані щодо найсвіжішої версії у верхній частині цієї сторінки.
    * Створіть відео щодо нових можливостей і викладіть його на Youtube. Чудовим інструментом для цього є [http://recordmydesktop.sourceforge.net/ recordmydesktop]. Якщо ви створили таке відео, не забудьте додайти його у розділ «Videos» домашньої сторінки програми (зразок у файлі <tt>README_new_video.txt</tt>).
     
    * Повідомте про випуск тим, хто створює бінарні пакунки для дистрибутивів


    ===Збирання випуску===
    ===Збирання випуску===
    Line 80: Line 90:
    {{Input|1=<nowiki>git clone git://anongit.kde.org/releaseme
    {{Input|1=<nowiki>git clone git://anongit.kde.org/releaseme
    cd releaseme</nowiki>}}
    cd releaseme</nowiki>}}
    To create the source package, run e. g.:
    Щоб створити пакунок із кодами, віддайте таку команду:
    {{Input|1=<nowiki>./tarme.rb --origin trunk --version 5.1 kphotoalbum</nowiki>}}
    {{Input|1=<nowiki>./tarme.rb --origin trunk --version 5.1 kphotoalbum</nowiki>}}


    === GIT Branches ===
    === Гілки GIT ===


    * ''master'' ([https://build.kde.org/job/kphotoalbum%20master%20kf5-qt5/PLATFORM=Linux,compiler=gcc build status])<br/>Current development branch
    * ''master'' ([https://build.kde.org/job/kphotoalbum%20master%20kf5-qt5/PLATFORM=Linux,compiler=gcc build status])<br />Поточна гілка розробки
    * ''4.7''<br/>Old stable (Qt4/Plasma4) branch. Only gets fixes for serious bugs on a case-by-case basis.
    * ''4.7''<br />Стара стабільна гілка (Qt4/Plasma4). Сюди слід записувати виправлення лише серйозних вад.
    * ''5.x''<br/>Branch tracked by [https://community.kde.org/Neon/Builder#The_Packaging Neon/stable].<br/>When ''master'' is in stable condition, it should be synced to ''5.x'': {{Input|1=<nowiki>git checkout 5.x ; git merge master</nowiki>}}
    * ''5.x''<br />Гілка [https://community.kde.org/Neon/Builder#The_Packaging Neon/stable].<br />Якщо ''master'' є стабільною, її слід синхронізуватиз ''5.x'': {{Input|1=<nowiki>git checkout 5.x ; git merge master</nowiki>}}
    * Feature branches are used in a very ad-hoc manner. If you are not a developer, don't bother with them.<br/>If you are a developer, try using descriptive names that are not likely to interfere with future branches.
    * Гілки можливостей використовуються за потреби. Якщо ви не є розробником, не створюйте їх.<br />Якщо ви розробник, намагайтеся використовувати описові назви, які не заважатимуть створенню нових гілок у майбутньому.


    ===Відомі вади та запити щодо нових можливостей ===
    ===Відомі вади та запити щодо нових можливостей ===
    Line 98: Line 108:
    ===Нові ідеї для наступних версій програми===
    ===Нові ідеї для наступних версій програми===


    Якщо у вас виникла нова ідея щодо покращення KPhotoAlbum, і ви вважаєте, що [https://bugs.kde.org/ bugs.kde.org] не зовсім те місце, де нею можна поділитися, скористайтеся [http://www.kphotoalbum.org/index.php?page=communication-media іншими каналами зв’язку з розробниками].
    Якщо у вас виникла нова ідея щодо покращення KPhotoAlbum, і ви вважаєте, що [https://bugs.kde.org/ bugs.kde.org] не зовсім те місце, де нею можна поділитися, скористайтеся [https://www.kphotoalbum.org/communication/ іншими каналами зв’язку з розробниками].


    [[Category:Графіка/uk]]
    [[Category:Графіка/uk]]

    Revision as of 19:07, 17 November 2017

    KPhotoAlbum — програма призначена для полегшення впорядкування зображень. У ній передбачено багато можливостей спрощення впорядкування та перегляду зображень.

    Перші версії KPhotoAlbum було випущено під назвою "KimDaBa". Стабільні випуски завжди можна знайти на нашій сторінці новин.

    Для початку, здійсніть трихвилинну подорож KPhotoAlbum або перегляньте відео на домашній сторінці KPhotoAlbum. Щоб дізнатися більше і переглянути деякі зі знімків екрана, відвідайте сторінку поширених питань і відповідей на них.

    У KPhotoAlbum передбачено підтримку всіх звичайних форматів зображень, зокрема нових форматів даних, у яких зберігають зображення цифрові фотоапарати та сканери (програма використовує для декодування даних dcraw). Крім того, ви можете скористатися мініатюрами, вбудованим до зображень цифрових негативів (такі мініатюри зазвичай мають менший розмір та нижчу якість), для пришвидшення попереднього перегляду (не потрібно декодувати зображення цифрового негатива).

    Користування KPhotoAlbum

    На сайті проекту можна знайти трихвилинний путівник і набір відеонастанов з програми. Крім того, ви можете скористатися підручником з KPhotoAlbum у форматі PDF та у форматі HTML.

    Отримання KPhotoAlbum

    Пакунки з початковими кодами, бінарні пакунки для різних дистрибутивів та архіви з кодами версії, що перебуває у розробці, можна звантажити зі сторінки звантажень проекту.

    KPhotoAlbum у портативних системах

    KPhotoAlbum є частиною Neon:

    • У редакції для користувачів (User Edition) міститься пакунок найсвіжішого випуску програми
    • У стабільній гілці редакції для розробників (Developer Edition) міститься пакунок версії 5.x.
      Найімовірніше, пакунок таий самий, як і пакунок нестабільної версії, але іноді, під час реалізації нових можливостей, можливості з’являються у стабільній версії лише після усування найпомітніших вад.
    • У нестабільній версії редакції для розробників (Developer Edition) міститься пакунок на основі гілки master коду kphotoalbum.

    Збирання KPhotoAlbum

    Покрокові настанови щодо збирання KPhotoAlbum з початкових кодів у Debian або Ubuntu наведено на сторінці Збирання KPhotoAlbum.

    Розширення можливостей KPhotoAlbum

    • Image::Kimdaba модуль мовоюs a perl, який зберігається у системі CPAN. Модуль призначено для обробки баз даних index.xml.
    • Ще одним способом розширення можливостей KPhotoAlbum є створення додатків KIPI (ці додатки використовуються і у інших програмах KDE для роботи з фотографіями). Додатки надають програмам додаткові можливості, зокрема можливості з експортування даних на веб-сайти Flickr, Picasa, Facebook тощо, виправлення штампів дат exif або виконання певних дій над зображенням. Сама програма KPhotoAlbum не виконує ніяких дій над файлами, лише читає з них дані.
    • Доступ до інших корисних скриптів можна отримати зі сторінки Wes Hardaker.
    • За допомогою Kimdaba2Mysql можна:
      • додати метадані з вашого файла index.xml до бази даних mysql;
      • створити форму пошуку на вашому веб-сайті на основі ваших ключових слів kimdaba, приклад можна знайти тут
    • Латки та список можливостей, які ще не реалізовано, наведено на сторінках bugs.kde.org.


    За допомогою скрипту pse3tokimdaba.pl можна видобути дані з вашої бази даних Photoshop Elements 3 і створити файл index.xml. Обмежень у дії цього скрипту доволі небагато (докладніше про них можна дізнатися зі сторінки, посилання на яку наведено вище).

    djKPA — веб-сайт Django, розроблений як веб-інтерфейс до вашого сховища фотографій KPhotoAlbum. djKPA виконує всі дії у повністю автоматичному режимі: мітки, позначки, описи та інші метадані беруться з бази даних KPhotoAlbum. Крім того, у djKPA передбачено повну інтерактивність: ваші відвідувачі можуть голосувати за фотографії, додавати коментарі, переглядати дані exif тощо, або переглядати ваші фотографії на основі категорій, створених за мітками.

    Як допомогти у розробці KPhotoAlbum

    Якщо ви бажаєте допомогти у розробці KPhotoAlbum або пов’язаних з ним проектів, будь ласка, зверніться до цієї сторінки проекту. Якщо у вас виникла ідея щодо покращення програми, зверніться до розділу «Реалізація нових можливостей», наведеного нижче.

    Документація для розробників

    Дії з приготування випуску KPA

    • Оновіть CMakeLists.txt, вказавши номер нової версії, гілку для яко щойно було створено (зараз автоматичне визначення версій не працює )
    • Оновіть ChangeLog, додавши дані щодо нового випуску і додайти опис ключових змін до списку змін, якщо про ці зміни ще не згадано у ChangeLog
    • Оновіть doc/index.docbook, змінивши у ньому розділи, пов’язані із новим випуском (якщо документацію було оновлено)
      <releaseinfo>4.5</releaseinfo>
    • Запишіть до локальної копії останні зміни
      git commit -v -a
    • Позначте новий випуск і надішліть зміни до сховища
      git tag -a -m "kpa 4.5 released" v4.5
      git push
      git push --tags
    • Створіть архів із кодом, скориставшись настановами із наступного розділу (kphotoalbum.rb --version 4.5)
    • Вивантажте створений архів до каталогу incoming на upload.kde.org за допомогою клієнтської програми FTP. Поточні настанови щодо інформування адміністраторів щодо вивантаження буде показано під час входу на сервер FTP. Вам слід створити квиток і вказати суми SHA на інші дані щодо вивантаженого.
    • Додайте нову версію у системі керування вадами (bugs.kde.org, для цього вам знадобляться права адміністратора): Edit Products → KPhotoAlbum → Add version
    • Оновіть вебсторінки KPA так, щоб вони вказували на відповідний файл кодів. Посилання на систему дзеркал ви отримаєте під час вивантаження архіву на сервер FTP KDE. Отримати вебсторінку пакунків з кодом можна за допомогою svn за адресою svn+ssh://[email protected]/home/kde/trunk/www/sites/kphotoalbum.
    • Оприлюдніть інформацію про випуск (сайт KPA, списки листування, системи стеження за вадами дистрибутивів, соціальні мережі тощо).
      • Не забудьте написати до списку листування kde-distro-packagers, згадавши у листі про будь-які зміни у залежностях.
      • Оновіть дані щодо найсвіжішої версії у верхній частині цієї сторінки.
    • Створіть відео щодо нових можливостей і викладіть його на Youtube. Чудовим інструментом для цього є recordmydesktop. Якщо ви створили таке відео, не забудьте додайти його у розділ «Videos» домашньої сторінки програми (зразок у файлі README_new_video.txt).
    • Повідомте про випуск тим, хто створює бінарні пакунки для дистрибутивів

    Збирання випуску

    Збирання архіву з випуском доволі просте. Встановіть програму для збирання releaseme і віддайте команди для збирання пакунка.

    git clone git://anongit.kde.org/releaseme
    cd releaseme

    Щоб створити пакунок із кодами, віддайте таку команду:

    ./tarme.rb --origin trunk --version 5.1 kphotoalbum

    Гілки GIT

    • master (build status)
      Поточна гілка розробки
    • 4.7
      Стара стабільна гілка (Qt4/Plasma4). Сюди слід записувати виправлення лише серйозних вад.
    • 5.x
      Гілка Neon/stable.
      Якщо master є стабільною, її слід синхронізуватиз 5.x:
      git checkout 5.x ; git merge master
    • Гілки можливостей використовуються за потреби. Якщо ви не є розробником, не створюйте їх.
      Якщо ви розробник, намагайтеся використовувати описові назви, які не заважатимуть створенню нових гілок у майбутньому.

    Відомі вади та запити щодо нових можливостей

    Список відомих вад у програми можна знайти на сторінці. Там же ви можете знайти можливі шляхи їх вирішення.

    Будь ласка, скористайтеся системою bugs.kde.org. Виберіть категорію «Wish» для вашого побажання.

    Нові ідеї для наступних версій програми

    Якщо у вас виникла нова ідея щодо покращення KPhotoAlbum, і ви вважаєте, що bugs.kde.org не зовсім те місце, де нею можна поділитися, скористайтеся іншими каналами зв’язку з розробниками.