Keskustelu: Ohjelmointiputka: Oppaat ladattaviksi paketeiksi?

Minulla ei ou nettiä joten toivoisin että oppaista olisi -esim- pakattu versio jonka voisi imuroida usb-tikulle ja viedä omalle koneelle. Varsinkin tuo Python-opas vaikuttaa mielenkiintoiselta!

Helpostihan nuo pystyy itsekin tallentamaan selaimen valikosta. Tulostettava versio -linkistä saa vielä paremmin tallennettavaksi sopivan sivun.

Minunkin mielestä olisi helpompi olla valmis toiminto tähän.

Olli kirjoitti:

Minunkin mielestä olisi helpompi olla valmis toiminto tähän.

Mitä vaikeaa nykyisessä systeemissä on? Eihän sun muuta tarvitse tehdä kuin klikata Tulostettava versio-linkkiä ja painaa Ctrl+S ja Enter.

Nykyinen systeemi on hankala, jos haluaa tallentaa koko opassarjan.

Parannusta asiaan on tarkoitus olla tulossa.

"Lataa pdf"-nappula olisi kiva. Se pakkaisi koko opassarjan yhdeksi pdf-tiedostoksi.

PDF:ää ei tueta >:o, koska sen kanssa tarvitaan ohjelma joka on päivitetty huippuunsa, sekä sen lukeminen ja käsitteleminen koodilla on nihkeää yms... Lisäksi on jo olemassa parempia tiedosto muotoja. Ja onko se kopioi + liitä yhdistelmä niin mahdoton.

PDF:hän se paras juuri olisi, silloin ulkoasu ei oppaassa muutu vaikka kone/käyttöjärjestelmä olisikin eri. Itselle sinänsä ihan sama mihin päätökseen päädyt(te) :P

P.S. tiedostomuoto on yhdyssana.

Jokotai: onko sinulla tarjota jotakin muuta vaihtoehtoa, kun mainitset paremmat tiedostomuodot? Minusta PDF:n tuomat edut ovat haittoja suuremmat. Se on kuitenkin periaatteessa jokaisen saatavilla, koska useimmissa käyttöjärjestelmissä se on olemassa lukijan muodossa jo valmiina. Tosin lukijan lataaminenkaan ei liene kovin suuri ongelma.

Tosin vaihtoehtoisetkin tavat lienevät aivan yhtä helppoja ladata, tosin mieleeni ei tule nyt yhtäään.

Minusta yksinkertaisesti HTML-tiedosto olisi aivan riittävä. Eihän täsmällisellä ulkoasulla ole mitään merkitystä, ja PDF:n kanssa esimerkiksi liian pitkät koodirivit aiheuttaisivat paljon enemmän ongelmia.

Jos nyt tuollainen all-in-one-sivu on pakko saada, toiminnon voisi toteuttaa yksinkertaisesti hakemalla kaikki opassarjan osat (printattavat versiot) file_get_contents-funktiolla peräkkäin.

Teuro kirjoitti:

Jokotai: onko sinulla tarjota jotakin muuta vaihtoehtoa, kun mainitset paremmat tiedostomuodot?

Vastaan Jokotain puolesta: HTML

Blaze kirjoitti:

Teuro kirjoitti:

Jokotai: onko sinulla tarjota jotakin muuta vaihtoehtoa, kun mainitset paremmat tiedostomuodot?

Vastaan Jokotain puolesta: HTML

Ei vaan LaTEX.

Ratkaisu on yksinkertainen: opassarjat voi ladata sekä HTML- että PDF-muodossa.

Yksi vaihtoehto olisi tosiaan muuttaa oppaat LaTeX-muotoon ja siitä edelleen PDF-muotoon.

Metabolix kirjoitti:

Jos nyt tuollainen all-in-one-sivu on pakko saada, toiminnon voisi toteuttaa yksinkertaisesti hakemalla kaikki opassarjan osat (printattavat versiot) file_get_contents-funktiolla peräkkäin.

Tai ehkä jokainen voisi netcatillä lähettää itse HTTP-pyynnön noihin tiedostoihin ja saada ne tulostettua tiedostoon?

Ehkä tässä kuitenkin haettiin jotain ns "valmista" ja helpottavaa juttua. PDF / HTML sama kait tuo...

tesmu kirjoitti:

Tai ehkä jokainen voisi netcatillä lähettää itse HTTP-pyynnön noihin tiedostoihin ja saada ne tulostettua tiedostoon?

Havaitsenko ns. vittuilua? En sanonut, että jokaisen pitäisi itse ne ladata, vaan ehdotukseni oli enemmänkin Antille suunnattu. Tällä tavalla jopa aivan "valmiin" ominaisuuden toteuttaminen kestäisi luultavasti vain pari hassua minuuttia.

Tietenkin käsin tehdessä toteuttaisin tuon komentorivillä wgetillä:

echo -n > python.html
for i in 01 02 03 04 05 06 07 08 09 10 11 12 l1 l2 ; do
  wget "https://www.ohjelmointiputka.net/oppaat/opas.php?tunnus=python_$i&t=1" -qO- >> python.html
done

Oho, menipä melkein minuutti! En kylläkään testannut koodia vielä, enkä testaakaan.

Jokotai kirjoitti:

PDF:ää ei tueta >:o, koska sen kanssa tarvitaan ohjelma joka on päivitetty huippuunsa.

Esimerkiksi Windowsille on olemassa mukavan kevyt Sumatra PDF.

Eihän se skriptin tekeminen oppaan kaikkien osien hakemiseksi tai sitten jokaisen sivun kopioiminen erikseen vaikeaa ole. Sen sijaan se on vaivalloista ja aivan turhaa työtä.

Ei se kauhean vaikea ole tehdä sivuillekaan sellaista skriptiä, joka osaa itse katsoa mikä opassarja on kyseessä ja montako osaa siihen kuuluu ja sen perusteella osaa ladata koko opassarjan tulostettavaan muotoon. Siihen samaan skriptiin olisi ihan kiva lisätä ominaisuus joka skannaa tekstin vielä läpi ja koostaa alkuun hyperlinkitetyn sisällysluettelon.

Tulostukseen muotoiltu HTML on mielestäni ihan riittävä, mutta tietty bookmarkattu pdf lisävaihtoehtona ois nice-to-have.

Metabolix kirjoitti:

En kylläkään testannut koodia vielä, enkä testaakaan.

Minä testasin. Ei toiminut. Tuloksena oli tyhjä python.html -tiedosto.

Aloittaja sanoi, että olisi kiva ladata ne ja lukea kotona jossa ei ole nettiyhteyttä. Osa vastailee tässä sillä perusteella, että laita oma sivu hakemaan ne, mutta mistä se hakee kun ei ole yhteyttä?

Torgo kirjoitti:

Minä testasin. Ei toiminut. Tuloksena oli tyhjä python.html -tiedosto.

Syynä näyttäisi olevan yksinkertainen kirjoitusvirhe osoitteessa. Lisäsin yhden merkin, kokeilepa nyt uudestaan.

Macro kirjoitti:

Osa vastailee tässä sillä perusteella, että laita oma sivu hakemaan ne

Kuka sinusta näin on vastannut?

Metabolix kirjoitti:

Macro kirjoitti:

Osa vastailee tässä sillä perusteella, että laita oma sivu hakemaan ne

Kuka sinusta näin on vastannut?

Torgo kirjoitti:

Ei se kauhean vaikea ole tehdä sivuillekaan sellaista skriptiä, joka osaa itse katsoa mikä opassarja on kyseessä ja montako osaa siihen kuuluu ja sen perusteella osaa ladata koko opassarjan tulostettavaan muotoon.

Metabolix kirjoitti:

Tietenkin käsin tehdessä toteuttaisin tuon komentorivillä wgetillä:

echo -n > python.html
for i in 01 02 03 04 05 06 07 08 09 10 11 12 l1 l2 ; do
  wget "https://www.ohjelmointiputka.net/oppaat/opas.php?tunnus=python_$i&t=1" -qO- >> python.html
done

Minusta hyvinkin sitä luokkaa.

Macro: Hassusti irrotat noita asiayhteydestä. Juuri samaisessa viestissä sanon, etten tarkoittanut, että kukaan itse koodaisi mitään, ja tuokin skripti on suunnattu vastaukseksi tesmun kummalliseen netcat-HTTP-ehdotukseen. Luultavasti myös Torgo suuntasi ehdotuksensa ylläpidolle eikä suinkaan käyttäjille.

Sitä paitsi pitäähän se nettiyhteys jossain olla, että voi ladata yhtään mitään, latasipa sitten yhden paketin tai kasan erillisiä sivuja. (Vai keksitkö Ohjelmointiputkan selaamiseen jonkin täysin nettiyhteydettömän ratkaisun?) Tuo skriptini on siinä mielessä oivallinen, että sillä nimenomaan voi ladata oppaat kerralla omalle koneelleen ja jopa yhdeksi tiedostoksi, minkä jälkeen yhteyttä ei enää tarvita.

Macro kirjoitti:

Metabolix kirjoitti:

Macro kirjoitti:

Osa vastailee tässä sillä perusteella, että laita oma sivu hakemaan ne

Kuka sinusta näin on vastannut?

Torgo kirjoitti:

Ei se kauhean vaikea ole tehdä sivuillekaan sellaista skriptiä, joka osaa itse katsoa mikä opassarja on kyseessä ja montako osaa siihen kuuluu ja sen perusteella osaa ladata koko opassarjan tulostettavaan muotoon.

Minusta hyvinkin sitä luokkaa.

Hetkinen... Enhän minä tuossa väitä että pitäisi tehdä oma sivu hakemaan ne. Tarkoitan nimenomaan palvelimella ajettavaa skriptiä joka koostaisi oppaan yhdeksi dokumentiksi. Palvelimen skriptin on helppo katsoa oppaasta mikä sen tunnus on ja montako osaa siihen kuuluu. Sen perusteella sen on helppo tuottaa printattavista sivuista yhtenäinen dokumentti ja generoida sille sisällysluettelo.

Metabolix kirjoitti:

Syynä näyttäisi olevan yksinkertainen kirjoitusvirhe osoitteessa. Lisäsin yhden merkin, kokeilepa nyt uudestaan.

Huomasin. Tarkoitus olikin vain vahvistaa pointtiani siitä että tuollaisen skriptin tekeminen on vaivalloista. Jos joku jolla ei ole kotona nettiyhteyttä, surffailee vaikka kirjaston koneella ja haluaisi kopioida netistä löytämänsä oppaan muistitikulle, niin ei sitä välttämättä ensimmäisenä huvittaisi alkaa skriptiä siihen vääntämään. Oppaiden lukijat monesti ovat muutenkin aloittelijoita, joka nostaa kynnystä vielä entisestään. Ja edes parhailta se ei onnistu pelkällä napin painalluksella, niin näen latausnapin entistä hyödyllisempänä.

Turha varmaan provosoitua ja muuttaa koko lanka väittelyksi täysin epäolennaisesta asiasta. Mielestäni Metabolixin alkuperäinen huomautus, että ehdotettu uusi ominaisuus olisi kohtuullisen turha, oli täysin asiallinen. Myös vastaukset jatkossa olivat mielestäni johdonmukaisia ja asiallisia puolustuksia - joskin ehkä ymmärränkin että joku niistä saattoi provosoitua.

Kuitenkin pääasia lienee se, että onko ehdotetusta uudesta ominaisuudesta hyötyä. Minustakin "lataa pdf"-namiska olisi mukava, mutta pdf:n luominen ei mielestäni ole aivan suoraviivaista, Metabolix ja Antti taisivatkin muutamasta ongelmasta mainita. Nimenomaan ehkä kaikkien tulostettavien versioiden yhdistelmä voisi olla joillekin hyödyllinen? Tällaisen yhdistelmän luominen olisi myös teknisesti hyvin yksinkertaista ja suoraviivaista.

EDIT:
PS. Kannattaa myös muistaa, että Ohjelmointiputkaa pidetään yllä harrastevoimin, joten on turha luoda "nice-to-have"-ominaisuuksia, mikäli kukaan ei kuitenkaan niitä käytä tai niistä hyödy.

Oletettavasti ainakin muutama käyttäjä niistä hyötyisi, kun kerran moisia toivovat.

Nyt opassarjat voi ladata yhtenä HTML-tiedostona.

Esimerkiksi Python-opassarja:

https://www.ohjelmointiputka.net/oppaat/sarja.php?tunnus=python

Yleensä jos ominaisuuden toteuttaminen vie vähemmän aikaa kuin sen hyödyttömyyden perusteleminen, mieluummin toteutan ominaisuuden.

Hyvä juttu, Antti. Jos on ylimääräistä aikaa voisi toteuttaa vielä sen pdf-ominaisuuden.

EDIT: Pitäisiköhän tuohon vielä lisätä niin ettei hakukoneet indeksoi nuita tulostettavia versioita? Niillehän on kyllä helpompi mutta käyttäjät päätyy hakukoneen kautta tulostettavaan versioon. robots="noindex"

Jos joku jostain kumman syystä sen PDF:n haluaa, niin eikös sen nyt saa tuosta HTML:stä aika triviaalisti ihan iteki? (File > Print > PDF > Print)

Jos jollakin ei satu olemaan PDF-tulostinta asennettuna niin ei saa. itseltä se tosin löytyy , mutta en näitä oppaita tiedostona tarvitsekaan.

EDIT: Vielä omaan edelliseen viestiin se, että Google on jo käynyt indeksoimassa tuon yhden tulostettavan sivun.

Voisiko linkki "koko opassarja" viedä aina samalle sivulle (python_01 eikä esim. python_02)? Myös tulostettavien versioiden indeksoinnin esto on minusta hyvä ajatus.

Nyt kaikissa osissa on sama linkki. Indeksoinnin esto on harkinnassa.

18 tulosta indeksoinut jo google.