add open help options in paperback android

Author: aryanchoudharypro

android/app/src/main/kotlin/dev/paperback/mobile/ui/MainScreen.kt

@@ -320,6 +320,9 @@ fun MainScreen(
 					} else {
 						importSettingsLauncher.launch(arrayOf("*/*"))
 					}
+				},
+				onHelpOpen = {
+					viewModel.openHelpDocument()
 				}
 			)
 		},

android/app/src/main/kotlin/dev/paperback/mobile/ui/MainScreenTopBar.kt

@@ -44,7 +44,8 @@ fun MainScreenTopBar(
 	onSleepTimerOpen: () -> Unit,
 	onElementsOpen: () -> Unit,
 	onExportSettings: () -> Unit,
-	onImportSettings: () -> Unit
+	onImportSettings: () -> Unit,
+	onHelpOpen: () -> Unit
 ) {
 	var moreOptionsExpanded by remember { mutableStateOf(false) }
 	Column(
@@ -211,6 +212,12 @@ fun MainScreenTopBar(
 										true
 									}
 								)
+								add(
+									CustomAccessibilityAction(t("Help")) {
+										onHelpOpen()
+										true
+									}
+								)
 							}
 						}
 					) {
@@ -301,17 +308,58 @@ fun MainScreenTopBar(
 								onSettingsOpen()
 							}
 						)
+						DropdownMenuItem(
+							text = { Text(t("Help")) },
+							onClick = {
+								moreOptionsExpanded = false
+								onHelpOpen()
+							}
+						)
 					}
 				}
 			} else {
+				var emptyMenuExpanded by remember { mutableStateOf(false) }
 				Box {
 					IconButton(
-						onClick = { onSettingsOpen() },
+						onClick = { emptyMenuExpanded = true },
 						modifier = Modifier.semantics {
-							traversalIndex = -1f
+							traversalIndex = 2f
+							this.onClick(label = "show all options in a menu") {
+								emptyMenuExpanded = true
+								true
+							}
+							customActions = listOf(
+								CustomAccessibilityAction(t("Settings")) {
+									onSettingsOpen()
+									true
+								},
+								CustomAccessibilityAction(t("Help")) {
+									onHelpOpen()
+									true
+								}
+							)
 						}
 					) {
-						Icon(Icons.Filled.Settings, contentDescription = "Settings")
+						Icon(Icons.Filled.MoreVert, contentDescription = t("More Options"))
+					}
+					DropdownMenu(
+						expanded = emptyMenuExpanded,
+						onDismissRequest = { emptyMenuExpanded = false }
+					) {
+						DropdownMenuItem(
+							text = { Text(t("Settings")) },
+							onClick = {
+								emptyMenuExpanded = false
+								onSettingsOpen()
+							}
+						)
+						DropdownMenuItem(
+							text = { Text(t("Help")) },
+							onClick = {
+								emptyMenuExpanded = false
+								onHelpOpen()
+							}
+						)
 					}
 				}
 			}

android/app/src/main/kotlin/dev/paperback/mobile/ui/MainScreenViewModel.kt

@@ -973,4 +973,29 @@ class MainScreenViewModel(
 	fun setShowPermissionRationale(show: Boolean) {
 		_showPermissionRationale.value = show
 	}
+
+	fun openHelpDocument() {
+		val lang = java.util.Locale.getDefault().language
+		val assetName = when (lang) {
+			"bs", "cs", "fi", "nl", "pl", "sr" -> "readmes/readme-$lang.html"
+			else -> "readmes/readme.html"
+		}
+		viewModelScope.launch(Dispatchers.IO) {
+			try {
+				val tempFile = File(context.cacheDir, "readme-$lang.html")
+				context.assets.open(assetName).use { input ->
+					FileOutputStream(tempFile).use { output ->
+						input.copyTo(output)
+					}
+				}
+				withContext(Dispatchers.Main) {
+					openDocument(Uri.fromFile(tempFile))
+				}
+			} catch (e: Exception) {
+				withContext(Dispatchers.Main) {
+					android.widget.Toast.makeText(context, dev.paperback.mobile.t("Failed to load document."), android.widget.Toast.LENGTH_LONG).show()
+				}
+			}
+		}
+	}
 }

crates/paperback-core/src/parser/mobi.rs

@@ -267,7 +267,7 @@ impl Parser for MobiParser {
 		if content.len() > MAX_MOBI_TEXT_BYTES {
 			content.truncate(MAX_MOBI_TEXT_BYTES);
 		}
-		let mut text = if text_encoding == 65001 {
+		let text = if text_encoding == 65001 {
 			String::from_utf8_lossy(&content).into_owned()
 		} else {
 			WINDOWS_1252.decode(&content).0.into_owned()
@@ -522,8 +522,7 @@ fn build_fragment_offsets(
 				pos = p;
 			}
 			if (control & 4) != 0 {
-				let (fid, p) = decode_vwi(data_rec, pos);
-				pos = p;
+				let (fid, _) = decode_vwi(data_rec, pos);
 				frag_offsets.insert(fid, insert_offset);
 			}
 		}
@@ -903,15 +902,6 @@ impl HuffmanDecoder {
 				}
 			}
 		}
-		while let Some(mut parent) = stack.pop() {
-			let finished_out = current.out;
-			if let Some(idx) = current.target_dict_index {
-				self.dictionary[idx] = Some((finished_out.clone(), true));
-			}
-			parent.out.extend_from_slice(&finished_out);
-			current = parent;
-		}
-		Ok(current.out)
 	}
 }
 

crates/xtask/src/android.rs

@@ -88,6 +88,46 @@ pub fn android() -> Result<(), Box<dyn Error>> {
 		}
 	}
 
+	let readmes_assets_dir = assets_dir.join("readmes");
+	let _ = fs::create_dir_all(&readmes_assets_dir);
+	let doc_dir = crate::project_root().join("doc");
+	let pandoc_config = doc_dir.join("pandoc.yaml");
+	if doc_dir.is_dir() {
+		let default_readme = doc_dir.join("readme.md");
+		if default_readme.exists() {
+			let status = Command::new("pandoc")
+				.arg(format!("--defaults={}", pandoc_config.display()))
+				.arg(&default_readme)
+				.arg("-o")
+				.arg(readmes_assets_dir.join("readme.html"))
+				.status();
+			match status {
+				Ok(s) if s.success() => {}
+				_ => println!("Warning: Failed to generate default English documentation"),
+			}
+		}
+		if let Ok(entries) = fs::read_dir(&doc_dir) {
+			for entry in entries.flatten() {
+				let path = entry.path();
+				if let Some(name) = path.file_name().and_then(|n| n.to_str()) {
+					if name.starts_with("readme-") && name.ends_with(".md") {
+						let out_name = name.replace(".md", ".html");
+						let status = Command::new("pandoc")
+							.arg(format!("--defaults={}", pandoc_config.display()))
+							.arg(&path)
+							.arg("-o")
+							.arg(readmes_assets_dir.join(out_name))
+							.status();
+						match status {
+							Ok(s) if s.success() => {}
+							_ => println!("Warning: Failed to generate documentation for language: {}", name),
+						}
+					}
+				}
+			}
+		}
+	}
+
 	if !gradle_tasks.is_empty() {
 		println!("Running gradlew with tasks: {:?}", gradle_tasks);
 		let android_dir = crate::project_root().join("android");