[WIP] Ship's library OXP

[Krager]

Здравствуйте! В вашей библиотеке есть небольшой баг. Как в версии Ships_Library_v0.8.1 так и в версии RUS_Ships_Library_v0.9.
При переслистывании страниц вперёд потом перелистываем назад нормально. А вот если перед эти не просматривать, а зайти через оглавление, назад не перелистывает. Выдаёт по одной букве в верхнем левом углу и картинки. Посмотрите пожалуйста можно ли починить.

----
Hello! There is a small bug in your library. Both in version Ships_Library_v0.8.1 and in version RUS_Ships_Library_v0.9.
When flipping pages forward then flip back normally. But if you don't look through the table of contents but go through the table of contents, it doesn't flip back. Gives one letter in the upper left corner and pictures. Please see if it can be fixed.

Translit deepl.com.

[phkb]

I can confirm the bug. I'll try to get a fix issued over the weekend.

[Krager]

I can confirm the bug. I'll try to get a fix issued over the weekend.

Сделайте пожалуйста для обоих версий 1.9 и 1.91.
Подскажите, сейчас делаю на основе вашей библиотеки дополнение (справочник) не пойму как сделать отступы. Возможно можно ещё как то раскрасить текст? Или вставить в текст маленькие картинки?
Получилось только на фон картинку поставить.

---

Please make it for both versions 1.9 and 1.91.
Could you tell me, now I'm making an add-on (reference book) based on your library, I don't understand how to make indents. Perhaps it is possible to color the text in some other way? Or insert small pictures in the text?
I only managed to put a picture on the background.
Translit deepl.com

[Cholmondely]

Сделайте пожалуйста для обоих версий 1.9 и 1.91.
Подскажите, сейчас делаю на основе вашей библиотеки дополнение (справочник) не пойму как сделать отступы. Возможно можно ещё как то раскрасить текст? Или вставить в текст маленькие картинки?
Получилось только на фон картинку поставить.

These may hopefully help...

*Columns in missionText (2015)
*Mission screen

I'm doubtful that there is any difference between 1.9 and 1.91 for Library... but Phkb will put me right if I'm wrong.

[Krager]

I can confirm the bug. I'll try to get a fix issued over the weekend.

Ещё один момент, если в библиотеке находиться больше одной книги, во время полёта нет возможности выбора книги. Можно читать только первую в списке. Можно добавить возможность ручной сортировки книг на станции или выбор книги из устройства в полёте

---

One more thing, if there is more than one book in the library, there is no possibility to select a book during the flight. You can read only the first book in the list. It is possible to add the possibility of manual sorting of books at the station or selecting a book from the device in flight .

[phkb]

I'm doubtful that there is any difference between 1.9 and 1.91 for Library... but Phkb will put me right if I'm wrong.

The big difference between 1.90 and 1.91 is the keyboard configuration, which has an impact on some of the keys you use in descriptions.plist to show them.

For example, here's a part of the missiontext.plist in the version for 1.90:

Code: Select all

"ingame-manual-ship-systems-lrc-text" = "...snip... Holding the 'Ctrl' key while pressing '[oolite_key_advanced_nav_array]' will instead highlight in cyan the quickest witchspace route. ...snip... available from high-tech shipyards.";

And here's the same bits from the 1.91 version:

Code: Select all

"ingame-manual-ship-systems-lrc-text" = "...snip... Holding the 'Ctrl' key while pressing '[oolite_key_advanced_nav_array_next]' will instead highlight in cyan the quickest witchspace route. ...snip... available from high-tech shipyards.";

That's the biggest difference when it comes to Ship's Library.

Please make it for both versions 1.9 and 1.91.

Will do.

Could you tell me, now I'm making an add-on (reference book) based on your library, I don't understand how to make indents. Perhaps it is possible to color the text in some other way? Or insert small pictures in the text?
I only managed to put a picture on the background.

You can't put images into the text directly. The only option, as you've noticed, is to set them as backgrounds. That is all we can do, I'm afraid!

You could design a page that has an image in a particular position, and then put indents to move the text around it. But that will be tricky to get right for both wide fonts (like Xolonium) and narrow fonts (like Dosis). You would be better off leaving whole-line gaps in your text, and arranging your backgrounds to fit into that gap.

On the good news front, I've found the bug, and fixed it. I'll update the manager shortly. I've also added a "Next book/Previous book" function to the MFD, and moved all text into missiontext.plist/descriptions.plist, so it should be easier to localise.

[Krager]

Спасибо большое! Жду обновления.

---

Thank you so much! Looking forward to the update.

[Cholmondely]

Just to add this (via a Yandex translation) from Roolite

Stranger:
Krager, it makes sense to use the potential of the Ships Library. since I had enough patience before its Russification. In principle, the package was designed not as a reader to pass the time in the queue for docking, but as an "in-game reference book". The manual on the basics of ship management in English is already there - you can first make a translation of it (if it has already been done, then I will remove the suggestion). And over time, it is possible to upload other OXP guides into it as well. Perhaps the Famous Planets can be inserted into the ship's library. You can also take a swing at the Merchant's Almanac, but this is a very laborious job - you need to write articles on EliteWiki for each system. But first, you can limit yourself to the Old Worlds, where a new Jameson begins to grow and develop. In my opinion, the potential of the ship's library as an "in-game reference book" is now being squandered.

Krager:
I started making help from the game for translated add-ons. So far, there are only 7 points) however, there is a beginning. I contacted the developer, I found a couple of points. Rewinding when entering through the menu led to a bug and there was not enough choice of books in flight, it showed only the first book from the list. The developer promised to make additions and post a new version.


1) Krager: Phkb is not the developer! Cim developed this OXP - and also developed the major game improvements in Oolite v.1.80 & v.1.82. He rarely visits the BB today.

Phkb is an immensely-obliging computer programmer who bends over backwards to help people!


2) Stranger's idea of adding the Rough Guide to the Ship's Library is a real corker! (I presume that he means the Rough Guide - Famous Planets already adds to the F7 screen).

[phkb]

And by the way, I posted the fix for Ship's Library. It's in the manager now.

On another note, having been working on "Iron Raven", I coded up the PDF brief in that OXP and turned it into a Ship's Library book. Turned out OK, I think:

[phkb]

2) Stranger's idea of adding the Rough Guide to the Ship's Library is a real corker!

OK, here you go: RoughGuide.oxz
Adds the Rough Guide to the Ship's Library. Enjoy!

Note: I haven't added any images to the system pages - it gets really messy if you want to try and put them mid-text.

[Krager]

And by the way, I posted the fix for Ship's Library. It's in the manager now.

On another note, having been working on "Iron Raven", I coded up the PDF brief in that OXP and turned it into a Ship's Library book. Turned out OK, I think:

Забрал) Всё работает, супер! На днях переведу на русский.
Вот бы ещё на будущее задуматься вынести тексты для удобства перевода отдельный файл. Вообще бы хорошо было))
Спасибо вам за ваш труд!

[phkb]

Because I had nothing else to do (!!) I had another look at Ship's Library, and worked out a way to unify the versions. So, version 0.10 should be in the manager shortly, and those on Oolite 1.90 will be able to upgrade to it.

I also added the ability to control the page height, so you can get more text on the page. There's an additional optional parameter in the _registerBook function call:

Code: Select all

worldScripts["Ships Library"]._registerBook("my_book_id", "My Book", contents, 22);

The "22" at the end there specifies the number of rows to use for text. The default is 15. You probably can't go past 22. So don't try it. Seriously.

*realises belatedly that he hasn't put any protection of that setting*

But no one would try to break it deliberately, would they? No. We're nice people.

[Cholmondely]

I've added your Rough Guide and the Ship Configuration Handbook to the Ship's Library wiki page.

Do you have a programme that you use for the conversion? Does it run on a Mac (and I've an old Windows computer I might be able to use instead)?

If not, I've a few more recommendations for easy conversions.

[phkb]

No conversion program for this one, unfortunately. It’s very manual. Not hard, but there are a lot of decisions you have to make page by page, so hard to make a program for it.

I don’t know why it’s taken me this long to realise, but the Ship’s Library is the perfect place to put things like equipment instruction manuals so that it’s in game, rather than hidden in a readme file or on the wiki. For a lot of mods it may only mean 1 or 2 pages per “book”, so more of a brochure, but it can get the info to where you need it.

[Cholmondely]

So what else might need a manual?

Hermitage?

SOTL?

PlanetFall2?

New Cargoes

There are the notes on combat strategy in the wiki.

There _are_ Ramirez’s PDFs. One doesn’t need the Feudal States one - it is all on the game bar a little of his introductory lore. The Dictators one is nice, short and mildly interesting. But the ones for his missions, yes.

Then I suppose Captain Hesperus’s flavour texts for the commies ships and stations.

Can’t really think of much else at the moment.