Update README file. [skip ci]

This commit is contained in:
Roman Telezhynskyi 2024-02-03 15:05:10 +02:00
parent 4e05c704cc
commit a82e9d6b03
5 changed files with 180 additions and 90 deletions

178
README.md Normal file
View file

@ -0,0 +1,178 @@
# Valentina
![Project status](https://img.shields.io/badge/Status-Active-green)
![Maintainer](https://img.shields.io/badge/Maintainer-Roman_Telezhynskyi-blue)
![GitLab Last Commit](https://img.shields.io/gitlab/last-commit/smart-pattern%2Fvalentina?style=flat)
[![Stable version](https://img.shields.io/badge/Stable-v0.6.1-blue)](https://smart-pattern.com.ua/valentina/version/0.6.1/)
[![Dev version](https://img.shields.io/badge/Dev-v0.7.52-yellow)](https://smart-pattern.com.ua/valentina/version/0.7.52/)
[![Build Status](https://api.cirrus-ci.com/github/dismine/valentina.svg)](https://cirrus-ci.com/github/dismine/valentina)
[![Build status](https://ci.appveyor.com/api/projects/status/m505f1pfs19j81nt/branch/develop?svg=true)](https://ci.appveyor.com/project/dismi_/valentina)
[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
Welcome to [Valentina](https://smart-pattern.com.ua/), a versatile cross-platform patternmaking program designed for creating and modeling clothing patterns. Whether you prefer using standard sizing tables or individual measurements, this software provides a flexible environment for pattern creation. Valentina seamlessly integrates modern technologies with traditional methods to offer a comprehensive patternmaking tool.
Key features:
1. **Versatile Pattern Creation:**
- Create intricate clothing patterns with ease, accommodating both standard sizing tables and personalized measurements.
2. **Intuitive Interface:**
- Enjoy a user-friendly design that caters to both beginners and experienced designers, making the patternmaking process accessible and efficient.
3. **Technology meets Tradition:**
- Seamlessly blend cutting-edge technologies with traditional patternmaking methods, providing a dynamic and efficient toolset for designers.
4. **Cross-Platform Compatibility:**
- Work seamlessly across various operating systems, including Windows, macOS, and Linux, ensuring a consistent experience for users.
5. **Collaborative Design:**
- Facilitate collaboration by sharing patterns effortlessly, enabling teamwork and creative cooperation among team members or clients.
6. **Precision and Accuracy:**
- Utilize Valentina's precision tools to ensure accurate and finely-tailored patterns, suitable for personal projects or professional collections.
## Installation
To install Valentina, please visit our website [Valentina Website] and download the version that best suits your needs. Valentina supports two branches: `stable` and `dev`. Version numbers follow a specific pattern to indicate stability and development status:
- **Stable Version:**
- Version numbers with even digits (e.g., 0.6) are reserved for stable releases.
- Stable versions receive bug fixes to ensure a reliable and stable user experience.
- **Dev Version:**
- Version numbers with odd digits (e.g., 0.7) represent the development branch.
- The dev version is actively developed and receives bug fixes and new features, providing a more feature-rich experience.
- While stable versions are suitable for initial checks, we recommend the dev branch for professional use due to its more advanced functionality.
Select the platform you use, and then choose the version most appropriate for your operating system. Versions marked with a "+" symbol indicate compatibility with the specified version of the OS and higher.
We recommend using the `dev` branch for professional use to take advantage of the latest features and improvements. If you encounter any issues, please refer to the **Support** section for assistance.
## Compilation
For advanced users and developers who want to compile Valentina from the source code, detailed instructions can be found in our [Wiki](https://gitlab.com/smart-pattern/valentina/-/wikis/home). The wiki provides step-by-step guidance on compiling Valentina on various platforms and includes information on dependencies and build configurations.
Please visit the [Wiki](https://gitlab.com/smart-pattern/valentina/-/wikis/home) for comprehensive instructions tailored to your development environment.
## Support
We value your experience with Valentina and are here to assist you at every step. For any questions, issues, or collaborative discussions, explore the various support channels available:
1. **Telegram Chat:**
Join our Telegram chat for real-time assistance and community support. Users engage in discussions, seek help, and share valuable feedback. The chat is available in English and Ukrainian.
[![Chat on Telegram](https://img.shields.io/badge/Chat-on_Telegram-green?logo=telegram)](https://t.me/valentina_project)
2. **Telegram Channel:**
Stay updated with the latest news and announcements about the Valentina project by subscribing to our Telegram channel. Get insights into new features, releases, and project developments.
[![Chat on Telegram](https://img.shields.io/badge/Channel-on_Telegram-green?logo=telegram)](https://t.me/smart_pattern)
3. **Instagram Accounts:**
Follow our Instagram accounts for visual updates and behind-the-scenes content. We have separate accounts for English and Ukrainian users, providing a diverse range of content related to Valentina.
[![Instagram En](https://img.shields.io/badge/Follow-on_Instagram_(En)-green?style=social&logo=instagram
)](https://t.me/smart_pattern)
[![Instagram Uk](https://img.shields.io/badge/Follow-on_Instagram_(Uk)-green?style=social&logo=instagram
)](https://t.me/valentina_project/)
4. **Facebook Groups:**
Engage with our community through Facebook groups. Join the English group for discussions and updates, or connect with the French-speaking community in our dedicated group.
[![Facebook Group - English](https://img.shields.io/badge/Follow-on_Facebook_(En,_It,_De)-green?style=social&logo=facebook
)](https://facebook.com/groups/valentina.en.it.de/?ref=share)
[![Facebook Group - French](https://img.shields.io/badge/Follow-on_Facebook_(Fr)-green?style=social&logo=facebook
)](https://facebook.com/groups/valentina.france/?ref=share)
5. **Issue Tracker:**
Report bugs, suggest improvements, and contribute to the ongoing development of Valentina by visiting our Issue Tracker. Your feedback is crucial in enhancing the user experience.
[![GitLab Issues](https://img.shields.io/gitlab/issues/open/smart-pattern%2Fvalentina)](https://gitlab.com/smart-pattern/valentina/-/issues/)
6. **User Manual and Shop:**
Visit our shop to explore the user manual, a valuable resource for mastering Valentina's features. By purchasing the manual, you not only gain in-depth insights but also contribute to supporting the continued development of the project.
[![Shop](https://img.shields.io/badge/Shop-now-informational)
](https://smart-pattern.com.ua/en/catalogue/)
If you prefer private communication, feel free to reach out through one of the following methods:
- **Email:**
Reach the maintainer, Roman directly at ![Mail maintainer](https://img.shields.io/badge/Mail-dismine@gmail.com-green?logo=gmail)
- **Telegram:**
Contact us privately on Telegram: [![Chat with maintainer](https://img.shields.io/badge/Chat-on_Telegram-green?logo=telegram)](https://t.me/crazy_snail)
- **Viber:**
Connect with us on Viber: [![Chat with maintainer](https://img.shields.io/badge/Chat-on_Viber-green?logo=viber&logoColor=white)](viber://chat?number=0380983467136)
- **WhatsApp:**
Chat with us on WhatsApp: [![Chat with maintainer](https://img.shields.io/badge/Chat-on_WhatsApp-green?logo=whatsapp)](https://wa.me/0380983467136)
- **Threema:**
Chat with us on Threema: [![Chat with maintainer](https://img.shields.io/badge/Chat-on_Threema-green?logo=threema)](https://threema.id/WVDPXTJC?text=)
We appreciate your active participation and feedback. Your involvement in the Valentina community is essential in shaping the future of our patternmaking tool.
## Contributing
Valentina welcomes contributions from the community, and your involvement can make a significant impact. Here are various ways you can contribute to the development and improvement of Valentina:
1. **Bug Reports:**
If you encounter any bugs or unexpected behavior, please report them on our [Issue Tracker](https://gitlab.com/smart-pattern/valentina/-/issues/). Provide detailed information about the issue, including steps to reproduce it and the operating system you're using. Your bug reports are crucial in enhancing the stability and performance of Valentina.
[![GitLab Issues](https://img.shields.io/gitlab/issues/open/smart-pattern%2Fvalentina)](https://gitlab.com/smart-pattern/valentina/-/issues/)
2. **Feature Suggestions:**
Share your ideas for new features or improvements to existing ones on the [Issue Tracker](https://gitlab.com/smart-pattern/valentina/-/issues/). We value your input and appreciate suggestions that can enhance the functionality and user experience of Valentina.
[![Feature proposal](https://img.shields.io/badge/Feature-propose-green)
](https://gitlab.com/smart-pattern/valentina/-/issues/new)
3. **Localization on Transifex:**
Help us make Valentina accessible to a global audience by contributing to localization efforts on [Transifex](https://explore.transifex.com/valentina/valentina-project/). Contribute translations, review existing ones, or suggest improvements to ensure that Valentina is available in multiple languages.
[![Translation](https://img.shields.io/badge/Translate-on_Transifex-green?logo=transifex)](
https://explore.transifex.com/valentina/valentina-project/)
4. **Code Contributions:**
If you're a developer and want to contribute code to Valentina, please follow our [Contribution Guidelines]. Your contributions can include bug fixes, new features, or improvements to the existing codebase.
5. **Community Involvement:**
Engage with the Valentina community on our Telegram Chat and Facebook Groups. Share your experiences, help fellow users, and participate in discussions about the future development of Valentina.
6. **Exclusive Expert Group:**
For deeply involved users interested in shaping the future of Valentina, consider joining our special group of experts. Contact us to request an invite and contribute to influential decisions about the direction of Valentina.
We appreciate your contributions and look forward to building a vibrant and collaborative community around Valentina.
## License
Valentina is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
Valentina is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
See LICENSE_GPL.txt file for further information
Other components released under:
* QMuParser - BSD license
* VPropertyExplorer - LGPLv2.1 license
## Links
* [Web site](https://smart-pattern.com.ua/)
* [Shop](https://smart-pattern.com.ua/catalogue/)
* [Chat](https://t.me/valentina_project/)
* [Issue tracker](https://gitlab.com/smart-pattern/valentina/-/issues/)
* [Source code](https://gitlab.com/smart-pattern/valentina/)

View file

@ -1,87 +0,0 @@
Pattern making program
Author Roman Telezhynskyi <dismine(at)gmail.com>
Copyright (C) 2013-2021 Valentina project
Valentina Web page: https://smart-pattern.com.ua/
Wiki: https://wiki.valentinaproject.org
Valentina main repository: https://gitlab.com/smart-pattern/valentina
PPA for Ubuntu (develop): https://launchpad.net/~dismine/+archive/valentina-dev
Help translate https://explore.transifex.com/valentina/valentina-project/
Valentina
==========
Valentina is a cross-platform patternmaking program which allows designers
to create and model patterns of clothing. This software allows pattern
creation, using either standard sizing tables or an individuals set of
measurements. It blends new technologies with traditional methods to create
a unique pattern making tool.
Compiling Valentina
====================
Prerequisites:
* Qt 5.4.0 or later (On Unix development packages needed)
* mercurial (only for working with repository)
* On Unix:
- g++ 4.8 or clang 3.4
- xpdf package (tool pdftops).
* On Windows:
- MinGW
- Xpdf is an open source viewer for Portable Document Format (PDF)
files. Website http://www.foolabs.com/xpdf/. Put tool pdftops.exe
in the same directory with Valentina's binary file.
The installed toolchains have to match the one Qt was compiled with.
You can build Valentina with
cd $SOURCE_DIRECTORY\build
qmake ..\Valentina.pro -r CONFIG+=noDebugSymbols CONFIG+=no_ccache
make (or mingw32-make or nmake or jom, depending on your platform)
Note: On some platforms e.g. Fedora, all Qt-tools come as qmake-qt5
etc. In this case you should install qtchooser. This wrapper
resolves the Qt version with respect to QT_SELECT. So run
export QT_SELECT=5
prior to qmake. You will not come along with just using qmake-qt5
here.
Note:In order to build and use Valentina, the PATH environment variable
needs to be extended:
PATH - to locate qmake, moc and other Qt tools
This is done by adding c:\Qt\%VERSION%\bin to the PATH variable.
For newer versions of Windows, PATH can be extended through the
Control Panel|System|Advanced|Environment variables menu.
You may also need to ensure that the locations of your compiler and
other build tools are listed in the PATH variable. This will depend on
your choice of software development environment.
Unix systems:
Default prefix for command "make install" is /usr. For using another
prefix build with qmake command:
qmake PREFIX=/usr/local PREFIX_LIB=/usr/lib/i386-linux-gnu Valentina.pro -r CONFIG+=noDebugSymbols CONFIG+=no_ccache
where /usr/local is a new prefix for installation binary files and /usr/lib/i386-linux-gnu is new prefix for install libraries.
LICENSING
==========
Valentina is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
Valentina is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
See LICENSE_GPL.txt file for further information
Other components released under:
* QMuParser - BSD license
* VPropertyExplorer - LGPLv2.1 license

View file

@ -34,7 +34,6 @@ AppUpdatesURL={#MyAppURL}
DefaultDirName={commonpf}\{#MyAppName}{#MyAppStatus}
DefaultGroupName={#MyAppName}{#MyAppStatus}
LicenseFile={#buildDirectory}\LICENSE_GPL.txt
InfoAfterFile={#buildDirectory}\README.txt
OutputDir={#buildDirectory}
ArchitecturesInstallIn64BitMode={#MyAppArchitecture}
ArchitecturesAllowed={#MyAppArchitecture}

View file

@ -349,7 +349,7 @@ win32:*g++* {
$$PWD/../../../dist/win/EUDC.TTE \
$$PWD/../../../AUTHORS.txt \
$$PWD/../../../LICENSE_GPL.txt \
$$PWD/../../../README.txt \
$$PWD/../../../README.md \
$$PWD/../../../ChangeLog.txt \
$$PWD/../../../share/qtlogging.ini \
$$PWD/../../libs/qmuparser/LICENSE_BSD.txt \

View file

@ -344,7 +344,7 @@ VToolApp {
"dist/win/pattern.ico",
"AUTHORS.txt",
"LICENSE_GPL.txt",
"README.txt",
"README.md",
"ChangeLog.txt",
"share/qtlogging.ini"
]