Fragment książki sekuraka – zobacz / zgłoś uwagi :)

23 lipca 2019, 18:35 | Aktualności | komentarzy 48
Tagi:
: zin o bezpieczeństwie - pobierz w pdf/epub/mobi.

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

Zapisując się na listę dostaniesz newsy o książce / powiązanych wydarzeniach. Obecnie zapisanych: 2493.

Dane osobowe przetwarzane są w celu przesyłania informacji związanych z książką sekuraka. Pod skrzydła wzięła nas firma: Securitum Szkolenia - tutaj zasady, wg których przetwarzane są Wasze dane osobowe: https://sekurak.pl/shp-dane-osobowe/

 

–ms

Spodobał Ci się wpis? Podziel się nim ze znajomymi:



Komentarze

  1. Maciej

    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.

    Odpowiedz
    • :) 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:)

      Odpowiedz
    • Filip

      ebook i czecionka jaką Pan sobie życzy, możesz na rzutniku czytac :)

      Odpowiedz
      • zero one

        Mam dziwne przeczucie Panie @Michale że Pan @Maciej preferuje kniżki papierowe. Jeśli się nie mylę pragnę nadmienić iż świetnie go rozumiem. ;-)

        Odpowiedz
      • zero one

        Troszkę wtopa. Napisałem do Pana Michała a to było do Pana Filipa. Przepraszam.

        Odpowiedz
  2. Michał

    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.

    Odpowiedz
    • Marek

      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

      Odpowiedz
  3. Marek

    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!

    Odpowiedz
    • 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 :/

      Odpowiedz
      • Jakub

        To zrobcie swoje skroty z domeny sekuraka

        Odpowiedz
        • Marek

          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ć.

          Odpowiedz
          • Piotr

            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 :-/

          • Monter

            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ł.

          • Marek

            „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

        • adrb

          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.

          Odpowiedz
      • Ruduś

        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.

        Odpowiedz
        • tzn wchodzisz na bloga i tam sobie już na luzaku klikasz?

          Odpowiedz
          • Ruduś
          • Monter

            O, i to samo proponuję dać jako indeks na końcu książki.

      • m

        Proponuję qrcody na marginesie

        Odpowiedz
  4. Marek

    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.

    Odpowiedz
    • Z tym autorem na każdej stronie to normalnie bez sensu – przy czym książka tu ma wielu autorów -> po to rozróżnienie.

      Odpowiedz
  5. Daro

    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”

    Odpowiedz
  6. Monter

    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).

    Odpowiedz
    • 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.

      Odpowiedz
  7. CodeBoy

    Jest jeszcze jeden babol , który mnie drażni, podpisy pod rysunkami zaczynają się od marginesu a nie od osadzenia obrazka.

    Odpowiedz
  8. Łukasz

    „Rysunek 1. asdfg” – to powinno być wyśrodkowane pod rysunkiem, a nie do lewej ;)

    Odpowiedz
  9. Marcin

    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.

    Odpowiedz
  10. Kuba

    Wasz formularz do subskrypcji ma chyba zbyt agresywne walidowanie :) nie przyjmuje polskich liter

    Odpowiedz
  11. Sebastian

    Jeszcze zwróćcie proszę uwagę, że pomieszane wielkie litery z małymi na ostatnich stronach są takie „gimnazjalne” ;)

    Odpowiedz
  12. nah

    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.

    Odpowiedz
    • najprawdopodobniej na tym stanie :)

      Odpowiedz
  13. 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.

    Odpowiedz
  14. Mart

    Zbyt duże marginesy. Zwłaszcza lewy i górny. Osobiście wolę numerację stron na środku strony.

    Odpowiedz
  15. Kontrybutor

    Kupie jak bedzie dostepny epub/mobi wraz z plikiem PDF. Tak sprzedaje ebooki informatyczne Helion i jest to najlepsza rzecz na rynku.

    Odpowiedz
    • Będzie epub i mobi, ale pdf to nie wiem :)

      Odpowiedz
  16. Kat

    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?”

    Odpowiedz
  17. Jacek

    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.

    Odpowiedz
    • Tak – prawdopodobnie będzie właśnie na koniec każdego rozdziału link do sekuraka – a tam cała bibliografia klikalna :)

      Odpowiedz
  18. Marcin

    Po wpisaniu polskich znaków w formularzu – Czym zajmujesz się zawodowo? – nie przechodzi walidacji (*Tylko litery) :D

    Odpowiedz
  19. Janusz

    a bedo koszulki dla pierwszych kupujących? Na hacking party nie było mnie jeszcze stać :(

    Odpowiedz
    • Raczej nie będą :) 69 PLN za taką tonę wiedzy to jest chyba nigdzie nie spotykana okazja :-)

      Odpowiedz
  20. Daniel

    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) :)

    Odpowiedz
  21. Krzysiek

    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

    Odpowiedz
  22. Tomek

    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)

    Odpowiedz
  23. Tomek

    Numery przypisów na dole strony również powinny być małą czcionką (superscript), a nie tak, jak reszta tekstu

    Odpowiedz

Odpowiedz