Preorder drugiego tomu książki sekuraka: Wprowadzenie do bezpieczeństwa IT. -15% z kodem: sekurak-book
Fragment książki sekuraka – zobacz / zgłoś uwagi :)
Po wakacjach (październik) wychodzi nasza papierowa książka o bezpieczeństwie aplikacji webowych. Prawdopodobnie będzie też wersja elektroniczna (epub, mobi).
- Spis treści – tutaj
- Przedsprzedaż & early access uruchamiamy w sierpniu (zapisy w formularzu na końcu tego posta :)
Fragment layoutu w wersji beta możecie zobaczyć tutaj. W tym pdf-ie nie przejmujcie się treścią – jeśli macie jakieś uwagi / propozycje odnośnie layoutu podrzućcie w komentarzach. Książka ma być dostępna w kolorze i mieć kilkaset stron.
Książka sekuraka – jedna ze stron
[wysija_form id=”19″]
–ms
Nie mam uwag, co do tego, co zostało zrobione. Natomiast mam uwagę ogólną, ponieważ jestem w tym wieku, że bez okularów nie dam rady czytać. Szczególnie chodzi mi o screeny, fragmenty kodu itp. Wiem, że to podnosi koszty druku, ale proszę o większą czcionkę, tam gdzie się da. Mam takie książki, że bez lupy nie da rady. Mam nadzieję, że ta taka nie będzie i czekam z niecierpliwością. Pozdrawiam.
:) Na druki czcionka jest całkiem spora (ale nie jakaś ogromna :). Powinno dać się czytać na luzie, bez męczenia wzroku. Obrazki też będą w hi-res (gdzie się da:)
ebook i czecionka jaką Pan sobie życzy, możesz na rzutniku czytac :)
Mam dziwne przeczucie Panie @Michale że Pan @Maciej preferuje kniżki papierowe. Jeśli się nie mylę pragnę nadmienić iż świetnie go rozumiem. ;-)
Troszkę wtopa. Napisałem do Pana Michała a to było do Pana Filipa. Przepraszam.
Ja może taką subiektywną uwagę dam, że dla mnie lepiej wygląda rozdzielenie akapitów poprzez odstęp aniżeli wcięcie – zwłaszcza przy małych akapitów jest to dla mnie bardziej czytelne.
Przez zrobienie odstępu zwiększa się ilość stron książki, a przy wielkości tej książki, to z każdego takiego odstępu zrobi się jakieś 30 dodatkowych stron
0. Najważniejsze: DAJCIE CZARNY TEKST (#000000) zamiast szarego (obecnie widzę #2C2E35) – oczy bolą jak czytam :(
1. Proponuję zdecydować się na 1 język. Jeżeli jest jakaś wstawka z RFC to przetłumaczcie. (tak, wiem że każdy umie po angielsku, ale nie o to chodzi, to po prostu dziwnie wygląda jak polski tekst jest przeplatany obcojęzycznymi wstawkami)
2. Dziwnie wygląda jak każde zdanie jest osobnym akapitem (druga połowa strony z obrazka), taki poszarpany jest ten tekst.
3. Proponuję większe odstępy między podtytułami/nagłówkami a tekstem poniżej
4. Na stronie 5 w PDF ramka obrazka przylega do tekstu, brzydko to wygląda
5. Kod/JSONy i inne takie można by spróbować zmieścić na 1 stronie (nawet kosztem tego, że spora część poprzedniej strony zostałaby pusta). To mocno zwiększyłoby czytelność. (przykład: payload przełamany na stronach 5/6)
6. Jeżeli celujecie najpierw w papier, to całkiem sporo linków jest do przepisywania. Jakbym miał przepisywać z papierowej książki coś takiego https://github.com/auth0/node-jsonwebtoken/commit/adcfd6ae4088c838769d169f8c-d9154265aa13e0 to przeklinałbym autora. ;) bit.ly waszym przyjacielem (ale proponuję nadać własne nazwy linkom), przy okazji będziecie mieli statystyki czy ktoś w ogóle wszedł na te linki ;P
7. Powtórzę jeszcze raz: czarny tekst zamiast szarego!
Dzięki za dobre uwagi.
ad1. -> wszystkie cytaty będą tłumaczone (w zasadzie już są, kwestia 'wlania’ w książkę).
ad6. -> to jest tricky, bo jak masz pełen link to wiesz gdzie wchodzisz. A skracaczach to nigdy nie wiadomo :/
To zrobcie swoje skroty z domeny sekuraka
Wg mnie dobry pomysł. Może nawet powiązany z przypisem, np. sekurak.pl/ksiazka1/przypis10 a w treści też dobrze przedstawić pełen adres by było wiadome gdzie wchodzić.
Idąc tym tropem to za 10 lat większość linków i tak nie będzie działać więc może od razu zrobić galerię screenów lub odnośniki do web archiwum lub czegoś podobnego. Niestety odwołania do stron internetowych jest niestabilne w czasie. Ja bym zrezygnował z odnośników do stron www, a zaprezentowałbym w załączniku na prawach cytatu widok danej strony w chwili publikacji Waszego tekstu. Chyba że ten book ma też założenie zmieniać się w czasie, mrrryy….. ;-)
P.s. z odsylaczami tak jest ze czasem ciekawe rzeczy są na prywatnych serwisach, gorzej jak nastąpi przejęcie takiego serwisu przez byt który będzie prezentował swoje reklamy i/lub swoje treści bez gwiazdek/cenzury, czy wstrzykiwał złośliwy kod :-/
No to jeszcze inaczej: linki krótkie jak proponowano przez stronę sekuraka, a z tyłu książki indeks linków i ich rozwinięcia do pełnej postaci. Dodatkowa kartka czy dwie a większy porządek w tekście, przypisach, no i zabezpieczenie gdyby skracacz zdechł.
„Idąc tym tropem to za 10 lat większość linków i tak nie będzie działać”
Za 10 lat, to ta książka nie będzie już aktualna
Ze skracaczami to niezbyt dobry pomysł, lepiej jak już ktoś pisał, żeby zrobić przekierowania ze stron w stylu: sekurak.pl/przypisy//
Będą właśnie przypisy tego typu na sekuraku
Co to zmieni? Dalej czytelnik nie wie gdzie wchodzi :) Nie mówiąc już o tym że strona sekuraka będzie musiała to serwować przez kolejne kilka lub kilka-naście lat, albo i dłużej.
Najprościej użyć alternatywnego linku, w tym wypadku np. https://github.com/auth0/node-jsonwebtoken/pull/352
Przy ciekawszych przypadkach, warto cytować nawet dłuższe fragmenty – źródło zawsze może zniknąć lub zmienić adres.
Jeżeli chodzi o sam tekst to na wstępie dodałbym jedno lub dwa zdania z łopatologicznym wyjaśnieniem co to jest JWT i do czego służy.
Co do linków – fajne rozwiązanie widziałem u jednego blogera – wszystkie linki z książki były w oryginale i można było je znaleźć u niego na blogu.
tzn wchodzisz na bloga i tam sobie już na luzaku klikasz?
Jest dokładnie tak jak mówisz. Na początku jest informacja o tym w książce, ze wszystkie linki są na blogu. W książce masz normalny link do danego materiału – dla chętnych do przepisania. A na blogu trzymacie wszystkie linki – które też można łatwo edytować jak coś się stanie.
Wygląda to tak:
https://jakoszczedzacpieniadze.pl/materialy-dodatkowe-ksiazka-zaufanie-czyli-waluta-przyszlosci
O, i to samo proponuję dać jako indeks na końcu książki.
Proponuję qrcody na marginesie
Czy w nagłówku potrzebne są dane autora? Jest na początku rozdziału.
Z tego co widzę, to margines lewy zawsze jest taki sam – niezależnie od tego, czy to strona parzysta czy nieparzysta… warto byłoby sprawdzić wydruk, czy jest to optymalne przy trzymaniu w dłoni.
Z tym autorem na każdej stronie to normalnie bez sensu – przy czym książka tu ma wielu autorów -> po to rozróżnienie.
Zwróćcie uwagę na sieroty/wdowy (typografia), wyłącznie dzielenia wyrazów w dziele książkowym. Zwrocie uwagę na szerokość tekstu – im Grubsza książka tym w środku ciężej czytać tekst przez zagięcie książki. Zalecam Adobe inDesign.. popatrzcie na Google „skład tekstu w książce”
Cytaty, kody, klucze, payloady, wstawki base64, itp., itd. – gdyby dać im bardzo jasne szare tło pod spodem (byle odróżnić się od białego) na pewno poprawiłoby to czytelność całości. Bez tego wszystko jest zlane ze sobą.
Listy numerowane – brak odstępu przed pierwszym punktem.
Brak odstępów po śródtytułach.
Obrazki jak rozumiem też full color w druku? Bo jak cz.b. to zdechnie ich czytelność (przypadłość wielu książek IT).
Dzięki. Niedługo będzie beta2 layoutu do zobaczenia :)
Obrazki mają być full color i w miarę możliwości w wysokiej rozdzielczości.
Jest jeszcze jeden babol , który mnie drażni, podpisy pod rysunkami zaczynają się od marginesu a nie od osadzenia obrazka.
„Rysunek 1. asdfg” – to powinno być wyśrodkowane pod rysunkiem, a nie do lewej ;)
1. Czarna czcionka zamiast szarej
2. Więcej odstępów zamiast wcięć.
3. Można dać mniejszy margines z lewej strony.
4. Nie spolszczajcie na siłę angielskich słów, które po polsku brzmią dziwnie :)
5. Może inna czcionka + większa interlinia ale nie jest źle.
Wasz formularz do subskrypcji ma chyba zbyt agresywne walidowanie :) nie przyjmuje polskich liter
Jeszcze zwróćcie proszę uwagę, że pomieszane wielkie litery z małymi na ostatnich stronach są takie „gimnazjalne” ;)
Jeżeli chodzi o linki, to najlepiej będzie stworzyć na domenie sekurak.pl stronę z ponumerowanymi całymi linkami z książki, np. sekurak.pl/ksiazka/linki – proste, bez skracania, wiadomo gdzie się wchodzi, żadne bit.ly, możecie podłączyć sobie statystyki ile osób skorzystało.
najprawdopodobniej na tym stanie :)
Chętnie zaprojektuję Wam całą publikację – od początku do końca. Tym bardziej, że na koncie poza mam sporo publikacji z zakresu twardego IT i z administrowaniem oraz bezpieczeństwem IT mam wiele wspólnego.
Zbyt duże marginesy. Zwłaszcza lewy i górny. Osobiście wolę numerację stron na środku strony.
Kupie jak bedzie dostepny epub/mobi wraz z plikiem PDF. Tak sprzedaje ebooki informatyczne Helion i jest to najlepsza rzecz na rynku.
Będzie epub i mobi, ale pdf to nie wiem :)
1. Ustalcie jedną czcionkę dla treści. Treść jest napisana inną, przypisy inną, nagłówki inną. Tak, mam świadomość, że kody/cytaty etc. Powinny być inną.
2. We fragmentach skryptów (str. 5 i 6) można spokojnie zmniejszyć odstępy pomiędzy wierszami. Nie zaburzy to czytelności tekstu, a nie będzie takie „rozwleczone”.
3. Cała treść może zostać przesunięta w lewo i zaczynać się np. od 2 litery nagłówka.
4. Ważne informacje poza tym, że podawane są w ramce, dobrze, żeby miały tło w inny kolorze (np. jasnoszarym)
5. Podpisy pod rysunkami powinny zaczynać się w miejscu osadzenia rysunku, a nie lewego marginesu nagłówka.
6. Kolor wklejonego komunikatu ze strony 9 – bardzo bola oczy od niego, mocno się rozmazuje ;( I może warto trzymać się też innej czcionki – takiej jak na tej samej stronie poniżej.
Raczej w ramach ciekawostki – jaki był zamysł ustawienia wymogu braku polskich znaków przy zapisach do książki z komentarzem „*tylko litery” :) w polu „Czym się zajmujesz zawodowo?”
W finalnej wersji sprawdźcie czy wszystkie adresu URL są linkami np. w przypisach np. 6, 19, 20, w tekście na stronie 12 drugi URL w ramce – nie są aktywne.
Może w książce drukowanej numerować każdy adres URL i na końcu zrobić indeks z kodami QR – czyli kilka stron z numerami linków i kodami QR.
Tak – prawdopodobnie będzie właśnie na koniec każdego rozdziału link do sekuraka – a tam cała bibliografia klikalna :)
Po wpisaniu polskich znaków w formularzu – Czym zajmujesz się zawodowo? – nie przechodzi walidacji (*Tylko litery) :D
a bedo koszulki dla pierwszych kupujących? Na hacking party nie było mnie jeszcze stać :(
Raczej nie będą :) 69 PLN za taką tonę wiedzy to jest chyba nigdzie nie spotykana okazja :-)
Ja wiem, że to książka dla geekoów i że wydajecie ją samodzielnie, ale przydałby się składacz i korektor, którzy wiele z tych uwag tutaj by wychwycili wcześniej.
Wspomniane już – kolor fonta, rozmiar i krój fonta, umiejscowienie podpisu rysunków i akapity, które zaczynają się od wcięcia + tłumaczenia, to na pewno najważniejsze rzeczy, ale są też inne, jak:
– wdówki
– interpunkcja
Te usługi nie są bardzo drogie, a znacznie zwiększają jakość książki, która merytorhcznie wydaje się być świetna (z zapowiedzi) :)
Zobacz z poprawkami: https://sekurak.pl/pelen-rozdzial-z-ksiazki-sekuraka-do-pobrania-w-pdf-start-przedsprzedazy-na-razie-10-sztuk/
Choć to jest i tak wersja przed final korektą :-)
Również jestem za tym aby nie łamać kawałków kodu/jsona. Jeśli miesci się na jednej stronie to na poprzedzającej zostawmy wolne miejsce. Kosztem nawet wyższej ceny książki
Numery stron – te [ naokoło ] przeszkadzają. Jeśli muszą zostać, to z wyraźnym rozróżnieniem, np. sam numer czarny, nawiasy szare (max grey50 lub jaśniejsze)
Numery przypisów na dole strony również powinny być małą czcionką (superscript), a nie tak, jak reszta tekstu
Uwaga co prawda nie dotyczy szaty wizualnej, jednak uwazam, że warto się nią podzielić. Mianowicie, nie wiem jak wy, ale do mnie w przypadku tak obszernego zakresu materiału lepiej przemawia rozbicie go na kilka podręczników skupiających się tylko na wybranej tematyce. Łatwiej jest się wtedy odnaleźć oraz wrócić do danego tematu.
Jeżeli jest to output, lub komenda generalnie tekst wypisywany na ekran to moim zdaniem powinno być zawarte w tabeli aby nie zlewało się z normalnym tekstem.
Kiedy możemy się spodziewać kolejnych informacji dotyczących książki? Do końca sierpnia miała być możliwość zamówienia egzemplarzy indywidualnie, mamy wrzesień, a dalej brak jakichkolwiek konkretniejszych informacji…
tak, mały delay, ale praca idzie pełną parą – przedsprzedaż miała być do końca tyg, ale jeszcze będzie pewnie z tydzień opóźnienia.
Czy są jakieś newsy na temat książki ?
Kiedy można się jej spodziewać ?
:)
Przyszły tydzień – przedsprzedaż.