Editing FoolFuuka/Asagi
From Bibliotheca Anonoma
Warning: You are not logged in. Your IP address will be publicly visible if you make any edits. If you log in or create an account, your edits will be attributed to your username, along with other benefits.
The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then publish the changes below to finish undoing the edit.
| Latest revision | Your text | ||
| Line 9: | Line 9: | ||
The Asagi Imageboard Archival Standard was developed by eksopl of Easymodo and the Foolz team under the direction of woxxy. It was developed to run the Foolz archiver, and has been the engine for the majority of archivers since the collapse of Archive.moe. | The Asagi Imageboard Archival Standard was developed by eksopl of Easymodo and the Foolz team under the direction of woxxy. It was developed to run the Foolz archiver, and has been the engine for the majority of archivers since the collapse of Archive.moe. | ||
Three versions can be identified: | |||
* Mark I (2009) - Produced for Foolz.us. Maybe in use by Nyafuu, was in use by Loveisover. | |||
* Mark II (2015) - Produced for Archive.moe. Used by Fireden and arch.b4k.co. | |||
* | * Mark III (2019) - The final reference standard codified by the Bibliotheca Anonoma, in preparation for the development of new drop-in replacements. | ||
* | |||
== Reference Implementation == | == Reference Implementation == | ||
| Line 27: | Line 21: | ||
** Despite the fact that PostgreSQL is supported by Asagi Scraper, it is not supported by FoolFuuka. | ** Despite the fact that PostgreSQL is supported by Asagi Scraper, it is not supported by FoolFuuka. | ||
* Scraper: Asagi (Java) - https://github.com/bibanon/asagi | * Scraper: Asagi (Java) - https://github.com/bibanon/asagi | ||
* Frontend: FoolFuuka (PHP) - https://github.com/ | * Frontend: FoolFuuka (PHP) - https://github.com/pleebe/FoolFuuka/tree/experimental | ||
* PHP Engine: Historically HHVM, PHP5.x compatible. Desuarchive and 4plebs now uses PHP 7. | * PHP Engine: Historically HHVM, PHP5.x compatible. Desuarchive and 4plebs now uses PHP 7. | ||
* Search: Sphinxsearch | * Search: Sphinxsearch | ||
| Line 54: | Line 48: | ||
Also check [[FoolFuuka/Install/Ubuntu16|FoolFuuka/Install/Ubuntu16]] | Also check [[FoolFuuka/Install/Ubuntu16|FoolFuuka/Install/Ubuntu16]] | ||
= How | = How asagi does stuff = | ||
== Configuration == | == Configuration == | ||
| Line 117: | Line 111: | ||
AbstractDumper.java ln. 95: <code>public void initDumper(BoardSettings boardSettings) {</code> | AbstractDumper.java ln. 95: <code>public void initDumper(BoardSettings boardSettings) {</code> | ||
== How | == How asagi decides to update a thread: == | ||
?dunno? | |||
== When asagi does a thread update: == | |||
== When | |||
in : YotsubaJSON.java, ln. 88: <code>public Topic getThread(int threadNum, String lastMod) throws ContentGetException, ContentParseException, CfBicClearParseException {</code> | in : YotsubaJSON.java, ln. 88: <code>public Topic getThread(int threadNum, String lastMod) throws ContentGetException, ContentParseException, CfBicClearParseException {</code> | ||
| Line 138: | Line 121: | ||
Loads thread JSON Decodes JSON For each post in the decoded thread JSON: Check if resto value is zero, and if so create a new thread from that post, updating lastmodified time to the time from fetching the JSON. <code>t = this.makeThreadFromJson(pj);</code> If resto is zero: Add the post to the current thread. <code>t.addPost(this.makePostFromJson(pj));</code> (What if two posts were resto==0? We’d break!) | Loads thread JSON Decodes JSON For each post in the decoded thread JSON: Check if resto value is zero, and if so create a new thread from that post, updating lastmodified time to the time from fetching the JSON. <code>t = this.makeThreadFromJson(pj);</code> If resto is zero: Add the post to the current thread. <code>t.addPost(this.makePostFromJson(pj));</code> (What if two posts were resto==0? We’d break!) | ||
== What does | == What does asagi do with a post in a thread? == | ||
Relevant files: >YousubaJSON.java >YotsubaAbstract.java | Relevant files: >YousubaJSON.java >YotsubaAbstract.java | ||
| Line 188: | Line 171: | ||
Sanitized? EXIF data YotsubaJSON.java (ln. 212): <code>p.setExif(this.cleanSimple(this.parseMeta(pj.getCom(), pj.getUniqueIps(), pj.getSince4pass(), pj.getTrollCountry())));</code> Return the Post() object. | Sanitized? EXIF data YotsubaJSON.java (ln. 212): <code>p.setExif(this.cleanSimple(this.parseMeta(pj.getCom(), pj.getUniqueIps(), pj.getSince4pass(), pj.getTrollCountry())));</code> Return the Post() object. | ||
== How | == How asagi handles an image in a thread? == | ||
Files of note: >Local.java - Saving image files | Files of note: >Local.java - Saving image files | ||
| Line 194: | Line 177: | ||
Local.java ln.201: <code>public void insertMedia(MediaPost h, Board source, boolean isPreview) throws ContentGetException, ContentStoreException, CfBicClearParseException {</code> | Local.java ln.201: <code>public void insertMedia(MediaPost h, Board source, boolean isPreview) throws ContentGetException, ContentStoreException, CfBicClearParseException {</code> | ||
== How | == How asagi deals with post deletions? == | ||
Relevant files: >src.java >src.java >src.java | Relevant files: >src.java >src.java >src.java | ||
| Line 385: | Line 368: | ||
== Images table values: == | == Images table values: == | ||
These seem to be handled by triggers that run on post insert. | These seem to be handled by triggers that run on post insert. ### 4ch -> (asagi) -> DB | ||
=== N/A -> (Incremental integer) -> “media_id” === | === N/A -> (Incremental integer) -> “media_id” === | ||
| Line 409: | Line 390: | ||
The relative path to the image on disk. (Triggers.sql ln.119-139): <code>TODO</code> | The relative path to the image on disk. (Triggers.sql ln.119-139): <code>TODO</code> | ||
=== N/A -> ( | === N/A -> (incerementer) -> “total” === | ||
The number of posts that refer to this row. | The number of posts that refer to this row. | ||
| Line 455: | Line 436: | ||
(AbstractDumper.java ln 161): - Fullsize media downloader thread <code>protected class MediaFetcher implements Runnable {</code> (AbstractDumper.java lln. 169): - Grab from queue thing <code>mediaPost = mediaUpdates.take();</code> (AbstractDumper.java lln. 173): - Try to handle the media for one post <code>mediaLocalBoard.insertMedia(mediaPost, sourceBoard);</code> (Local.java ln. 201): - Handler for a post with media <code>public void insertMedia(MediaPost h, Board source, boolean isPreview) throws ContentGetException, ContentStoreException, CfBicClearParseException {</code> (Local.java ln. 201): - Interact with DB for this media <code>mediaRow = db.getMedia(h);</code> | (AbstractDumper.java ln 161): - Fullsize media downloader thread <code>protected class MediaFetcher implements Runnable {</code> (AbstractDumper.java lln. 169): - Grab from queue thing <code>mediaPost = mediaUpdates.take();</code> (AbstractDumper.java lln. 173): - Try to handle the media for one post <code>mediaLocalBoard.insertMedia(mediaPost, sourceBoard);</code> (Local.java ln. 201): - Handler for a post with media <code>public void insertMedia(MediaPost h, Board source, boolean isPreview) throws ContentGetException, ContentStoreException, CfBicClearParseException {</code> (Local.java ln. 201): - Interact with DB for this media <code>mediaRow = db.getMedia(h);</code> | ||
If there is information for this media in the DB, | If there is information for this media in the DB, retreive it. If any new information exists about this media that is not already in the DB, add that to the DB entry. (SQL.java ln. 289): - Interact with DB for this media <code>public synchronized Media getMedia(MediaPost post) throws ContentGetException, ContentStoreException, DBConnectionException {</code> | ||
(SQL.java ln. 342-347): - Decide if media row needs an update | (SQL.java ln. 342-347): - Decide if media row needs an update | ||
| Line 516: | Line 497: | ||
(Ln. 22) <code>public Topic(int num, int omPosts, int omImages) {</code> | (Ln. 22) <code>public Topic(int num, int omPosts, int omImages) {</code> | ||
Data flow: 4ch -> | Data flow: 4ch -> asagi -> DB | ||
?Seems to be handled by DB triggers.? | ?Seems to be handled by DB triggers.? | ||
