-15% na nową książkę sekuraka: Wprowadzenie do bezpieczeństwa IT. Przy zamówieniu podaj kod: 10000

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

23 lipca 2019, 18:35 | Aktualności | komentarze 54
Tagi:

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

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
  24. Adrian

    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.

    Odpowiedz
  25. Marcin

    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.

    Odpowiedz
  26. Piotr

    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…

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

      Odpowiedz
  27. Marcin

    Czy są jakieś newsy na temat książki ?
    Kiedy można się jej spodziewać ?
    :)

    Odpowiedz
    • Przyszły tydzień – przedsprzedaż.

      Odpowiedz

Odpowiedz na sekurak