-
Notifications
You must be signed in to change notification settings - Fork 16
/
Copy pathForBeginnersRU.txt
executable file
·79 lines (60 loc) · 6.32 KB
/
ForBeginnersRU.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
Infromation for beginners RU
----------------------------
В этом документе описана вся информация, которая может понадобится новичку, чтобы начать вносить вклад в проект "Editor."
1. Что такое Sailfish OS?
-------------------------
Чтобы понять особенность и философию Sailfish OS, что очень важно, если хотите правильно разрабатывать под эту ОС, прочтите раздел `Общая информация`: https://github.com/GoAlexander/sailfishos-wiki/blob/master/SFOSGetStarted.md#1-Общая-информация
2. Устанавливаем Sailfish OS SDK + Hello World
----------------------------------------------
- Читаем статьи по порядку:
https://habrahabr.ru/post/305510/
https://habrahabr.ru/post/306188/
- Также в процессе разработки советую читать все статьи от организации FRUCT: https://habrahabr.ru/users/fruct/topics/
- Большое количество вопросов можно задать в чате русскоговорящего сообщества: sailfish.su/telegram
- Очень советую с кодом и слайдами с летней школы Sailfish OS:
https://github.com/GoAlexander/sailfishos-wiki/tree/master/codeSummerSchool2016
https://github.com/GoAlexander/sailfishos-wiki/tree/master/slidesSummerSchool2016
-Или просмотреть видео с летней школы Sailfish OS: https://vk.com/videos-40681615?section=album_55658014
Особенно:
https://vk.com/video-40681615_456239031
https://vk.com/video-40681615_456239032
https://vk.com/video-40681615_456239033
-Несколько шпаргалок: https://github.com/GoAlexander/sailfishos-wiki/tree/master/cheatsheets
3. Описание логики и структуры файлов "Editor." для версии 0.4.2
----------------------------------------------------------------
Дерево проекта в файловом представлении (показаны только самые важные файлы и папки):
(!) - таким занком обозначены файлы, которое обязательно понадобятся
.
├── harbour-editor.desktop -> "ярлык" приложения
├── harbour-editor.pro -> (!)QT-файл проекта (после клонирования репозитория добавьте в QT этот файл - проект автоматически загрузится). Не забываем при добавлении новых библиотек и переводов добавлять их в этот файл
├── icons -> Папка для иконок
├── qml -> Папка со всеми qml. QML используется для построения интерфейсов
│ ├── components -> Здесь располагаются самописные/кастомные компоненты (кнопки, меню и т.д.)
│ │ ├── AuthorRow.qml
│ │ └── MenuButton.qml
│ ├── cover -> (!)Папка для интерфейса cover. Cover - это "прямоугольники" с главного экрана ОС
│ │ └── CoverPage.qml
│ ├── editFile.py -> (!)Здесь код для сохранения/загрузки/автосохранения документов + функции для загрузки настроек из .json
│ ├── harbour-editor.qml -> (!)Самая первая qml страница, которая загружается при старте приложения (на самом деле ее пользователь не видит), ее задача подгрузить все остальные qml. Также здесь располагаются глобальные переменные.
│ ├── img -> Здесь лежат все дополнительные картинки/иконки
│ │ └── tab.svg
│ └── pages -> Папка с основными qml. Здесь вы будете проводить большую часть времени :)
│ ├── AboutPage.qml -> Информация о программе. При появлении новых переводчиков - обновляем
│ ├── FileChooserPage.qml -> Файловый браузер для выбора документа
│ ├── FirstPage.qml -> (!) Основная страница приложения. Здесь располагаются: текстовое поле и меню
│ ├── HistoryPage.qml -> Страница с историей ранее открытых документов
│ ├── SaveAsPage.qml -> Файловый браузер для сохранения документа
│ └── SettingsPage.qml -> (!) Страница со всеми настройками
├── rpm
│ ├── harbour-editor.spec -> Автогенерируемый файл. Руками не трогать!
│ └── harbour-editor.yaml -> (!)Здесь не забываем менять версию приложения, когда выпускаете новую версию :)
├── src
│ └── harbour-editor.cpp -> С++ код подгружает все qml-файлы. Здесь и находится main() программы :)
└── translations
Как показывает практика `FirstPage.qml` самый часто редактируемый файл, там и ведется основная работа.
4. Ссылки на ресурсы проекта
----------------------------
Github:https://github.com/GoAlexander/harbour-editor
Trello (todo):https://trello.com/b/Gyu7pPqi/harbour-editor
Openrepos:https://openrepos.net/content/goalexander/editor
Дружественныйпроект - tIDE (можно "воровать фичи", но при этом не забываем тоже делать вклад в его проект): https://github.com/eekkelund/harbour-tIDE